> ## Documentation Index
> Fetch the complete documentation index at: https://docs.muhasip.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP’ye bağlan

> Muhasip API dokümanlarını yapay zekâ aracınıza bağlayın; güncel rehberlerden ve işlem örneklerinden yararlanın.

MCP (Model Context Protocol), yapay zekâ aracınızın Muhasip API dokümanlarında arama yapmasını ve ilgili sayfaları okumasını sağlar. Böylece entegrasyon kodu hazırlarken istek alanlarına, cevap örneklerine ve işlem koşullarına doğrudan erişebilirsiniz.

## Bağlantı bilgileri

| Ayar | Değer |
| - | - |
| Sunucu adı | `muhasip-docs` |
| Sunucu adresi | `https://docs.muhasip.pro/mcp` |
| Bağlantı türü | Streamable HTTP |
| Kimlik doğrulama | Gerekmez |

```text MCP adresi theme={null}
https://docs.muhasip.pro/mcp
```

<Note>
  Bu bağlantı dokümanlara erişim sağlar; fatura oluşturma, ödeme veya kayıt değiştirme işlemlerini çalıştırmaz. Bağlantı
  ayarlarına Muhasip API anahtarınızı eklemeyin.
</Note>

## Aracınıza ekleyin

Sayfanın üstündeki menüden MCP adresini kopyalayabilir veya Cursor ve VS Code bağlantı seçeneklerini kullanabilirsiniz. Adresle bağlantı destekleyen diğer araçlarda yeni bir uzak MCP sunucusu ekleyip yukarıdaki bilgileri girin.

<Tabs>
  <Tab title="Codex">
    Codex CLI yüklüyse terminalde çalıştırın:

    ```bash theme={null}
    codex mcp add muhasip-docs --url https://docs.muhasip.pro/mcp
    ```

    Dosyadan yapılandırmak için `~/.codex/config.toml` dosyanıza aşağıdaki bölümü ekleyebilirsiniz. Mevcut sunucu ayarlarınızı koruyun; komutla eklediyseniz aynı kaydı tekrar eklemeyin.

    ```toml theme={null}
    [mcp_servers.muhasip-docs]
    url = "https://docs.muhasip.pro/mcp"
    ```

    Yeni bir Codex oturumu açın. CLI’da `/mcp` ile bağlantıyı kontrol edebilirsiniz.

    [Codex MCP bağlantı ayarları](https://developers.openai.com/codex/mcp)
  </Tab>

  <Tab title="Cursor">
    Sayfa menüsündeki Cursor bağlantı seçeneğini kullanın. Dosyadan eklemek için projenizin `.cursor/mcp.json` dosyasında `mcpServers` altına bu sunucuyu ekleyin:

    ```json theme={null}
    {
      "mcpServers": {
        "muhasip-docs": {
          "url": "https://docs.muhasip.pro/mcp"
        }
      }
    }
    ```

    Mevcut sunucularınız varsa yalnız `muhasip-docs` kaydını ekleyin. MCP ayarlarından bağlantının etkin olduğunu kontrol edin.

    [Cursor MCP bağlantı ayarları](https://cursor.com/docs/mcp)
  </Tab>

  <Tab title="VS Code">
    Komut paletinde **MCP: Add Server** komutunu açın. **HTTP** seçeneğini seçip `https://docs.muhasip.pro/mcp` adresini ve sunucu adı olarak `muhasip-docs` değerini girin. Kaydın kullanılacağı kapsamı seçin.

    Dosyadan eklemek için projenizin kökündeki `.mcp.json` dosyasında aşağıdaki kaydı kullanabilirsiniz:

    ```json theme={null}
    {
      "mcpServers": {
        "muhasip-docs": {
          "type": "http",
          "url": "https://docs.muhasip.pro/mcp"
        }
      }
    }
    ```

    Mevcut sunucu kayıtlarını koruyun. **MCP: List Servers** komutuyla `muhasip-docs` bağlantısını kontrol edin ve sohbetinizde sunucunun araçlarını etkinleştirin.

    [VS Code MCP bağlantı ayarları](https://code.visualstudio.com/docs/agent-customization/mcp-servers)
  </Tab>
</Tabs>

## Bağlantıyı kullanın

Yapay zekâ aracınıza şu isteği gönderin:

```text theme={null}
Muhasip API dokümanlarını MCP üzerinden ara. Fatura taslağı oluşturmak için
gereken alanları, izinleri ve Idempotency-Key koşulunu kaynak sayfalarıyla açıkla.
```

Cevapta ilgili Muhasip doküman sayfalarının bağlantıları bulunmalıdır. Ardından ihtiyacınızı belirterek kod örneği isteyebilirsiniz:

* “Banka hareketlerini listelemek için filtreleri ve sayfalamayı açıkla; Node.js örneği hazırla.”
* “Tahsilat bağlantısı oluşturmak için gereken alanları bul ve PHP örneği yaz.”
* “Mali işlem sonucu belirsiz kaldığında hangi durumu sorgulamam gerektiğini göster.”

Türkçe sorular sorabilirsiniz. Üretilen kodu uygulamanıza almadan önce ilgili [işlem referansındaki](/api-reference/servis/core-get-apps) alanları ve [mali işlem kurallarını](/rehberler/islem-takibi) kontrol edin.

## Bağlantı kurulamıyorsa

* Aracınızın uzak MCP sunucularına **Streamable HTTP** ile bağlanabildiğini ve adresin `https://docs.muhasip.pro/mcp` olduğunu kontrol edin.
* Kaydettiğiniz sunucuyu etkinleştirip yeni bir sohbet veya oturum açın. Araç listesinden doküman arama ve okuma araçlarının erişilebilir olduğunu doğrulayın.
* Doküman bağlantısı için kimlik bilgisi istenirse sunucu adresini ve bağlantı türünü kontrol edin; Muhasip API anahtarınızı girmeyin.

MCP bağlantısı kullanamıyorsanız [doküman dizinini](https://docs.muhasip.pro/llms.txt) veya [OpenAPI sözleşmesini](/openapi.json) aracınıza kaynak olarak verebilirsiniz. API entegrasyonuna başlamak için [hızlı başlangıç](/baslangic/hizli-baslangic) rehberine geçin.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.