MCP’ye bağlan

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

MCP adresi

https://docs.muhasip.pro/mcp

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.

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.

Codex
Cursor
VS Code

Codex CLI yüklüyse terminalde çalıştırın:

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.

[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ı

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:

{
  "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ı

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:

{
  "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ı

Bağlantıyı kullanın

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

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 alanları ve mali işlem kurallarını 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 veya OpenAPI sözleşmesini aracınıza kaynak olarak verebilirsiniz. API entegrasyonuna başlamak için hızlı başlangıç rehberine geçin.

API’ye başlayın

Ortak kavramlar

Bağlantı bilgileri

Aracınıza ekleyin

Bağlantıyı kullanın

Bağlantı kurulamıyorsa

​Bağlantı bilgileri

​Aracınıza ekleyin

​Bağlantıyı kullanın

​Bağlantı kurulamıyorsa

Bağlantı bilgileri

Aracınıza ekleyin

Bağlantıyı kullanın

Bağlantı kurulamıyorsa