> For the complete documentation index, see [llms.txt](https://docs.compliance.phalcon.blocksec.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.compliance.phalcon.blocksec.com/tr/integrations/mcp-server.md).

# MCP Sunucusu

Bu kılavuz, Model Context Protocol (MCP) kullanarak Phalcon Compliance'ı bir AI asistanına nasıl bağlayacağınızı açıklar. Bağlantı kurulduğunda, Phalcon Compliance panosuna geçiş yapmadan doğrudan asistanınızla yaptığınız bir konuşma sırasında adresleri ve işlemleri tarayabilir, mevcut tarama sonuçlarını okuyabilirsiniz.

Phalcon Compliance, AML riskini belirler ve raporlar. Ancak riske yönelik işlem yapmaz: MCP sunucusu yalnızca okuma ve tarama işlemleri yapar; hesabınızda herhangi bir değişiklik yapamaz.

## Ön koşullar

* Etkin bir Phalcon Compliance hesabı. Tüm planlarda kullanılabilir.
* Uzak MCP sunucularını destekleyen bir AI asistanı.

## Asistanınızı bağlayın

Phalcon Compliance, MCP sunucusunu barındırır. Yüklenecek bir şey yoktur ve sunucu otomatik olarak güncel tutulur.

Aşağıdaki sunucu URL'sini, asistanınızın MCP sunucularını veya bağlayıcılarını yönettiği yere ekleyin:

```
https://mcp.blocksec.com/mcp
```

Asistanınız Phalcon Compliance'ı ilk kez çağırdığında, tarayıcınızda bir yetkilendirme sayfası açılır:

1. Phalcon Compliance'ta oturum açın veya bir hesap oluşturun.
2. Verdiğiniz izinleri gözden geçirin: geri yönlendirileceğiniz yer, bağlantının kullanacağı hesap ve kuruluş ve bağlantının yapabilecekleri. Geri dönüş adresini tanıdığınızı onaylamanız istenirse onaylayın; aksi takdirde devam edemezsiniz.
3. **Yetkilendir** seçeneğini belirleyin.

Asistanınız bağlandı. Bağlantı kaldırılmadığı veya süresi dolmadığı sürece yeniden yetkilendirmeniz istenmez.

<figure><img src="https://3389189486-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhyFzquVK3pLPEJLYQ3SG%2Fuploads%2Fgit-blob-cfc1fdc28aa022afb5ad95e1252142d7ed892277%2Fmcp-server-authorization.png?alt=media" alt="The Phalcon Compliance authorization page, showing where you will be sent back to, the account and organization the connection will use, a checkbox confirming you recognize the return address, and what the connection will be able to do"><figcaption><p>The authorization page shows the account and organization the connection will use, and what it will be able to do.</p></figcaption></figure>

### Belirli asistanlar için kurulum

Aşağıda asistanınızla ilgili talimatları izleyin. Claude Code, Codex ve Cursor, sunucu URL'sine ek olarak yapılandırmalarında gösterilen client ID'yi gerektirir. Değeri aynen kopyalayın: bu değer Phalcon Compliance hesabınızı değil, asistanı tanımlar ve bir API anahtarı değildir. Sunucu URL'sinin sonuna eklemeyin.

Burada listelenmeyen bir asistan için bağlantı talimatlarını almak üzere <phalcon_support@blocksec.com> adresiyle iletişime geçin.

#### Claude

**Customize → Connectors** bölümüne gidin, **+** seçeneğini, ardından **Add custom connector** seçeneğini belirleyin ve sunucu URL'sini yapıştırın.

Team ve Enterprise planlarında, bir sahip bağlayıcıyı **Organization Settings → Connectors** altında bir kez ekler. Ardından üyeler bağlayıcıya ayrı ayrı bağlanır.

#### Claude Code

```bash
claude mcp add --scope user --transport http \
  --client-id https://claude.ai/oauth/claude-code-client-metadata \
  phalcon-compliance https://mcp.blocksec.com/mcp
```

`--scope user`, sunucuyu her projede kullanılabilir hale getirir. Bu seçeneği kullanmazsanız sunucu yalnızca o anda içinde bulunduğunuz projeye eklenir.

#### Codex

```bash
codex mcp add phalcon-compliance \
  --url https://mcp.blocksec.com/mcp \
  --oauth-client-id https://chatgpt.com/oauth/codex/client.json
```

Sunucu, Codex CLI, IDE uzantısı ve masaüstü uygulamasının tümünün okuduğu `~/.codex/config.toml` dosyasına yazılır. Bir kez eklemek üçünü de kapsar.

#### Cursor

Sunucuyu `mcp.json` dosyanıza ekleyin:

```json
{
  "mcpServers": {
    "Phalcon Compliance": {
      "url": "https://mcp.blocksec.com/mcp",
      "auth": {
        "CLIENT_ID": "https://cursor.com"
      }
    }
  }
}
```

`CLIENT_ID`, hesabınızı değil Cursor'ın kendisini tanımlar. Gösterildiği gibi aynen kopyalayın.

#### VS Code (GitHub Copilot)

Projenizde `.vscode/mcp.json` dosyasını oluşturun:

```json
{
  "servers": {
    "phalcon-compliance": {
      "type": "http",
      "url": "https://mcp.blocksec.com/mcp"
    }
  }
}
```

Üst düzey anahtar `mcpServers` değil, `servers` olmalıdır. Ardından pencereyi yeniden yükleyin ve Copilot Chat'i **Agent** moduna geçirin — MCP araçları yalnızca bu modda kullanılabilir.

#### ChatGPT

Özel MCP sunucuları Developer Mode ve ücretli bir ChatGPT planı gerektirir ve yalnızca web'de çalışır. Business, Enterprise ve Edu çalışma alanlarında, herhangi biri özel bir MCP sunucusu ekleyebilmeden önce yöneticinin özel MCP'yi etkinleştirmesi gerekir.

[Developer Mode'u etkinleştirme ve özel bir bağlayıcı ekleme](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt) için OpenAI talimatlarını izleyin ve yukarıdaki sunucu URL'sini kullanın. Kimlik doğrulamayı OAuth olarak bırakın.

## Asistanınız neler yapabilir?

İsteğinizi doğal dille sorun — asistanınız uygun işlemi seçer.

| İsteyebilecekleriniz                      | Tarama kotası kullanır          |
| ----------------------------------------- | ------------------------------- |
| Bir adresi AML riski açısından tarama     | Evet — 1 tarama                 |
| Bir işlemdeki transferi tarama            | Evet — transfer başına 1 tarama |
| Bir adresin en son tarama sonucu          | Hayır                           |
| Bir işlemdeki transferlerin listesi       | Hayır                           |
| Bir transferin en son tarama sonucu       | Hayır                           |
| Sıraya alınmış bir taramanın sonucu       | Hayır                           |
| Belirli bir dönemdeki tarama kullanımınız | Hayır                           |
| Desteklenen zincirlerin listesi           | Hayır                           |

**Scale ve Enterprise** planlarında asistanınız ayrıca toplu istek gönderebilir — istek başına en fazla 100 adres veya 50 işlem. Bir toplu istekteki her öğe bir tarama kullanır.

Her tarama sonucu, Phalcon Compliance panosundaki ilgili kayda bir bağlantı içerir.

{% hint style="warning" %}
Tarama sonuçları, taramanın çalıştırıldığı andaki durumun anlık görüntüsüdür ve asistanınız bunları özetleyebilir veya başka sözcüklerle ifade edebilir. Bir uyumluluk kararı vermeden önce bağlantı verilen pano kaydını açın.
{% endhint %}

### Zincir seçme

Aynı adres veya işlem hash'i birden fazla zincirde bulunabilir. Hangi zinciri kastettiğinizi belirtmezseniz, adres biçimi Bitcoin, Tron ve Solana adreslerinde olduğu gibi tek bir zinciri kendiliğinden tanımlamadığı sürece asistanınız tarama yapmadan önce size sorar. Bu soruyu yanıtlamak kota kullanmaz.

Sonuçlarda hangi zincirin kapsandığı belirtilir. İşlem yapmadan önce bunun kastettiğiniz zincir olduğunu kontrol edin.

### Bir işlemi tarama

Tarama, işlem düzeyinde değil transfer düzeyinde yapılır. Beş transfer içeren bir işlemin tamamını kapsamak için beş tarama gerekir.

Bir işlem birden fazla transfer içeriyorsa, asistanınız tarama yapmadan önce hangisini kastettiğinizi sorar — genellikle fonları alan adresi sorar. Bu soruyu yanıtlamak normal bir adımdır, hata değildir ve transfer belirlenene kadar kota kullanılmaz.

Varsayılan olarak, tarama fonların hem nereden geldiğini hem de nereye gittiğini kapsar. Yalnızca tek bir yöne ihtiyacınız varsa asistanınızdan taramayı bu yönle sınırlandırmasını isteyin. Her iki durumda da bir tarama kullanılır.

### Risk düzeyleri

Risk düzeyleri sabit bir ölçeğe değil, kendi Risk Engine kurallarınıza dayanır. Her bulgu, onu oluşturan kural için belirlediğiniz önem derecesini taşır ve genel düzey, bu derecelerin en yükseğidir. Aynı adres, başka bir kuruluş için farklı bir düzeyde sonuç verebilir.

Bunun iki sonucu vardır:

* Genel düzey en yüksek tekil bulguya dayandığından, asistanınıza bu düzeyi hangi bulgunun belirlediğini sorun.
* **Risk Yok**, kurallarınızla hiçbir eşleşme bulunmadığı anlamına gelir. Adresin veya transferin temiz olduğu anlamına gelmez.

Yalnızca düzeye güvenmek yerine asistanınızdan düzeyin arkasındaki kanıtları — eşleşen göstergeyi, tutarları ve eşleşen olay sayısını — isteyin.

Kurallar Phalcon Compliance panosunda yapılandırılır ve Essential planlarda ve üzerindeki planlarda kullanılabilir. Asistan üzerinden değiştirilemezler.

## Tarama kotası

Asistanınız üzerinden yapılan taramalar, pano ve API ile aynı kotayı kullanır. Ayrı bir kullanım hakkı yoktur.

Mevcut sonuçları okumak hiçbir zaman kota kullanmaz. Yakın zamanda alınmış bir sonuç zaten varsa, asistanınız yeni bir tarama yapmak yerine bu sonucu okuyabilir. Güncel duruma ihtiyacınız olduğunda yeniden tarama yapmasını isteyin — bu yeni bir tarama çalıştırır ve kotanızdan bir tarama kullanır.

Kotanız tükendiğinde asistanınız size bilgi verir ve faturalandırma sayfasına bağlantı verir. Kullanımınızı istediğiniz zaman kontrol etmek için asistanınızdan tarama kullanımınızı isteyin veya panoyu açın.

## İzinler

Bağlantının izinleri, Phalcon Compliance panosunda sahip olduğunuz izinlerle tam olarak aynıdır — ne fazlası ne eksiği.

Kuruluştaki rolünüz yalnızca görüntüleme iznine sahipse, asistanınız mevcut tarama sonuçlarını okuyabilir ancak yeni tarama başlatamaz. Tarama başlatmanız gerekiyorsa erişim için kuruluş yöneticinizden istekte bulunun.

Asistan, kendisi için salt okunur erişim de isteyebilir. Bağlantının yapabilecekleri, **Yetkilendir** seçeneğini belirlemeden önce yetkilendirme sayfasında listelenir.

## Kuruluş

Bağlantı tek bir kuruluşa bağlıdır: yetkilendirme sırasında en son kullandığınız kuruluşa. **Yetkilendir** seçeneğini belirlemeden önce kuruluş, yetkilendirme sayfasında gösterilir.

Farklı bir kuruluş kullanmak için, o kuruluş etkin durumdayken bağlantıyı kesin ve yeniden bağlanın.

## Bağlantıyı kesme

Phalcon Compliance sunucusunu asistanınızın MCP veya bağlayıcı ayarlarından kaldırın. OAuth token iptalini destekleyen asistanlar, o anda erişim token'ını da iptal eder.

Erişimin sona erdiğine dair onaya ihtiyacınız varsa ***<phalcon_support@blocksec.com>*** adresiyle iletişime geçin.

## Sınırlamalar

* **Yalnızca okuma ve tarama.** Bağlantı, kara liste ve beyaz liste girdileri ekleyemez veya kaldıramaz, müşterileri düzenleyemez, izlemeyi başlatamaz veya durduramaz ya da uyarılar ve vakalar üzerinde işlem yapamaz.
* **Monitoring, Alert Hub, Customer Management ve Risk Engine yapılandırması** asistan üzerinden kullanılamaz. Bunlar için panoyu veya API'yi kullanın.
* Toplu istek göndermek için Scale veya Enterprise planı gerekir.

## Sonraki Adımlar

* [Adres Taraması](https://docs.compliance.phalcon.blocksec.com/tr/user-manual/screening/addresses.md): panoda adresleri tarama.
* [İşlem Taraması](https://docs.compliance.phalcon.blocksec.com/tr/user-manual/screening/transactions.md): transfer düzeyinde taramanın nasıl çalıştığı.
* [Planlar, Faturalandırma ve Ödeme](https://docs.compliance.phalcon.blocksec.com/tr/user-manual/account/plans-billing-and-payment.md): kota ve plan sınırları.
* [API Belgeleri](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/introduction.md): temel REST API.
