Yapay Zeka & MCP Protokolü
Bulgaristanbot, yapay zeka asistanları ve LLM ajanları için Model Context Protocol (MCP) standartlarını destekler. Bu sayede Claude, Cursor veya özel yapay zeka ajanlarınız, kullanıcıların vatandaşlık dosyalarını doğrudan sohbet penceresinden sorgulayabilir.
🛠️ Desteklenen MCP Araçları (Tools)
Section titled “🛠️ Desteklenen MCP Araçları (Tools)”MCP uç noktamız (/mcp) yapay zeka ajanlarına aşağıdaki araçları sunar:
1. check_citizenship_status
Section titled “1. check_citizenship_status”- Açıklama: Verilen dosya numarası ve PIN ile Bulgaristan Adalet Bakanlığı sistemini sorgular ve anlık durumu döndürür.
- Girdi Parametreleri:
reqNum(string, zorunlu): Dosya numarası (örn:14820/2023).pin(string, zorunlu): 6 haneli gizli PIN kodu.
2. get_stages_guide
Section titled “2. get_stages_guide”- Açıklama: Bulgaristan vatandaşlık sürecinin tüm aşamalarını, kurumlar arası güvenlik tahkikatını ve Ukaz sürelerini açıklayan bilgi bankasını döndürür.
💻 Claude Desktop Kurulumu
Section titled “💻 Claude Desktop Kurulumu”Claude Desktop uygulamanıza Bulgaristanbot sorgulama yeteneğini eklemek için:
claude_desktop_config.json dosyanızı açın ve aşağıdaki sunucu yapılandırmasını ekleyin:
{ "mcpServers": { "bulgaristanbot": { "url": "https://bgsorgulama.bulgaristanvatandas.com/mcp" } }}Claude Desktop’ı yeniden başlattığınızda, çekiç simgesi (tools) altında check_citizenship_status aracını görebilir ve doğrudan Claude’a:
“14820/2023 dosyamın durumunu kontrol eder misin? PIN: 582910”
diyerek sorgulama yaptırabilirsiniz.
💻 Cursor & Windsurf Entegrasyonu
Section titled “💻 Cursor & Windsurf Entegrasyonu”Cursor IDE’de MCP sunucusu eklemek için:
- Cursor Settings > Features > MCP Servers bölümüne gidin.
- Add New MCP Server butonuna tıklayın.
- Bilgileri girin:
- Name:
Bulgaristanbot - Type:
SSE / HTTP Streamable - URL:
https://bgsorgulama.bulgaristanvatandas.com/mcp
- Name:
- Kaydedin. Artık Cursor Composer veya Chat üzerinden dosya durumlarını sorgulayabilirsiniz.
🌐 Doğrudan HTTP POST MCP Çağrısı
Section titled “🌐 Doğrudan HTTP POST MCP Çağrısı”Kendi özel yapay zeka ajanınızı (LangChain, LlamaIndex, AutoGen vb.) geliştiriyorsanız:
curl -X POST "https://bgsorgulama.bulgaristanvatandas.com/mcp" \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "method": "tools/call", "params": { "name": "check_citizenship_status", "arguments": { "reqNum": "14820/2023", "pin": "582910" } }, "id": 1 }'