ajan Agent MCP sunucusu

ajan ajanlarınıza herhangi bir MCP uyumlu yapay zekâ istemcisinden erişin. ajan MCP Sunucusu çalışma alanı ajanlarınızı MCP araçları olarak sunar.

ajan MCP Sunucusu ajan ajanlarınızı MCP araçları olarak sunar; böylece herhangi bir MCP uyumlu yapay zekâ istemcisi çalışma alanı ajanlarınızla etkileşime geçebilir.

Bu ne için? Bu, harici yapay zekâ araçlarının (Claude Desktop, Cursor veya diğer MCP istemcileri gibi) ajan ajanlarınızı doğrudan çağırmasına olanak tanır. Ajanlarınız, herhangi bir MCP uyumlu uygulamanın kullanabileceği araçlar haline gelir.

MCP temel URL'si

ajan MCP sunucusu https://api.ajan.io/mcp adresinde kullanılabilir.

Kuruluşunuz özel bir ajan dağıtımı (özel alan adı) kullanıyorsa bunun yerine dağıtımınızın uç noktasını kullanın: https:///api/public/mcp. Bu rehber boyunca https://api.ajan.io/mcp yerine bu URL'yi kullanın.

Kimlik doğrulama

MCP uç noktası, Agent API kapsamına sahip geçerli bir ajan API anahtarı gerektirir.

API anahtarınızda Agent API kapsamının etkin olduğundan emin olun. Çalışma alanı yöneticileri çalışma alanı ayarlarında API anahtarları oluşturabilir veya yönetebilir.

Desteklenen kimlik doğrulama yöntemleri

Başlık türü	Başlık biçimi
Bearer	`Authorization: Bearer`
X-API-Key	`x-api-key:`

Kullanılabilir araçlar

ajan MCP Sunucusu üç araç sunar:

Araç	Açıklama
`find_agent`	Ada göre ajan kimliği ara
`ask_agent`	Kimliğiyle belirtilen bir ajana istem gönder
`ask_custom_agent`	Anlık özel ajan yapılandır ve sorgula

find_agent

Yalnızca adını bildiğinizde bir ajanın kimliğini bulmak için bunu kullanın. ask_agent çağırmak istediğinizde ancak önce doğru ajan kimliğini bulmanız gerektiğinde yararlıdır.

ask_agent

Kimliğini kullanarak belirli bir ajana istem gönderin. Ajan isteğinizi yapılandırılmış modeli, talimatları ve bağlı entegrasyonlarıyla işler.

Çok turlu konuşmalar için önceki turları isteğe bağlı messageHistory parametresi üzerinden iletin. Her girdinin user veya assistant olan bir role değeri ve bir content dizesi vardır. Girdileri eskiden yeniye sıralayın; geçerli prompt en son kullanıcı turu olarak eklenir.

json

{
  "agentId": "agent_123",
  "prompt": "And what about Berlin?",
  "messageHistory": [
    { "role": "user", "content": "What's the weather in Munich?" },
    { "role": "assistant", "content": "Munich is currently 18°C and sunny." }
  ]
}

ask_custom_agent

Tek bir sorgu için özel ayarlarla geçici bir ajan oluşturun. ajan'da kalıcı bir ajan oluşturmadan spesifik davranış gerektiğinde kullanışlıdır.

ajan'dan bağlanma

Bu MCP sunucusunu eklemek için Create integrations iznine ihtiyacınız vardır. Add integration görünmüyorsa bir çalışma alanı yöneticisinden bu izni vermesini veya entegrasyonu sizin için oluşturmasını isteyin.

Bu MCP sunucusunu ajan içinde bir entegrasyon olarak eklemek istiyorsanız şu adımları izleyin:

Entegrasyonlara gidin

Ana gezinmeden Integrations açın.

MCP entegrasyonu ekleyin

Add integratione tıklayın, Start from scratch seçin, ardından Connect remote MCP seçin.

Sunucu ayrıntılarını girin

URL: https://api.ajan.io/mcp
Authentication method API Key

Kaydet ve test et

Create and connecte tıklayın
Geçerli bir ajan API anahtarıyla bir bağlantı ekleyin (Agent API kapsamına sahip olmalı)
API Key Header Type değerini Authorization: Bearer olarak ayarlayın
Kullanılabilir araçlara erişimi doğrulamak için Test connectione tıklayın

İlgili belgeler

Model Context Protocol (MCP) - MCP hakkında ve diğer MCP sunucularına nasıl bağlanılacağı
MCP sunucu dizini - Resmi MCP sunucularına göz atın
Agents API rehberi - Agents API'yi doğrudan kullanın

SSS

Harici bir MCP uyumlu istemcinin ajan ajanlarına araç olarak erişmesi gerektiğinde ajan Agent MCP Sunucusunu kullanın. Ekipler ajan ajanlarını ajan arayüzü dışında yeniden kullanmak istediğinde kullanışlıdır.

MCP istemci yapılandırmasını, kimlik doğrulamayı, ajan paylaşımını, kullanılabilir araçları ve hedef ajanın yayınlanıp erişilebilir olup olmadığını kontrol edin. Harici istemcinin gerekli MCP davranışını desteklediğini de doğrulayın.