AI CodeOps

MCP sunucuları

Son güncelleme

AI CodeOps ajanlarının araçlarını çağırabilmesi için uzak MCP sunucularını bağlayın: bir sunucu ekleyin, başlıklarını şifreli tutun, araçları ajan ve politika bazında sınırlayın.

Model Context Protocol (MCP), bir yapay zekâ ajanının bir iş takip aracı veya dokümantasyon araması gibi başka bir hizmetteki araçları çağırmasını sağlar. AI CodeOps'ta MCP sunucularını çalışma alanınıza bağlarsınız ve oturumlarınızdaki ajanlar bu sunucuların araçlarını kullanabilir.

Burada AI CodeOps istemcidir: eklediğiniz MCP sunucularına kendisi bağlanır. Bunun yerine AI CodeOps'u kendi kodlama asistanınızdan kullanmak için bkz. AI CodeOps MCP sunucusu.

MCP desteği beta aşamasındadır.

Uzak ve yerel sunucular

TürNe girersinizOturumlar kullanır mı?
Remote (HTTP/SSE URL)Sunucunun URL'si ve HTTP başlıklarıEvet
Local (stdio command)Bir komut ve ortam değişkenleriHayır. Kaydedilir, ancak oturumlar onu başlatmaz.

Oturumlar bilgisayarınızda değil, platformda çalışır; dolayısıyla makinenizde bir program başlatamazlar. Ajanlarınızın çağırması gereken her şey için uzak bir sunucu kullanın.

Uzak sunucular:

  • herkese açık bir HTTPS adresinde olmalıdır (özel ağlar ve localhost reddedilir);
  • MCP Streamable HTTP aktarımını desteklemelidir (POST üzerinden JSON-RPC; JSON veya olay akışı yanıtıyla);
  • bearer token gibi sabit başlıklarda kimlik doğrulamayı kabul etmelidir. OAuth ile giriş gerektiren sunucular henüz desteklenmiyor; yalnızca SSE kullanan eski aktarım da desteklenmiyor.

Bir sunucu ekleyin

  1. Configure → MCP Servers sayfasını açın ve Add MCP server düğmesini seçin.
  2. Name alanına bir ad girin; örneğin "GitHub". AI CodeOps sunucunun kimliğini bu addan, küçük harfle ve tirelerle oluşturur: "GitHub" adı github, "Docs Search" adı docs-search olur. Araç adları ve politika kuralları bu kimliği kullanır.
  3. Remote (HTTP/SSE URL) seçeneğini seçin ve Server URL alanını doldurun.
  4. Headers altında her satıra bir KEY=value ekleyin; örneğin:
    Authorization=Bearer <your token>
  5. Save MCP server düğmesini seçin.

Sunucu Servers altında Disable ve Remove düğmeleriyle görünür. Henüz bir düzenleme formu yoktur: bir sunucuyu değiştirmek için onu kaldırıp yeniden ekleyin.

MCP sunucularını yönetmek için MCP-manage izni gerekir: varsayılan olarak Owner, Admin ve DevOps Admin.

Secret'lar nasıl saklanır

Başlıklar (uzak) ve ortam değişkenleri (yerel) depolanırken AES-256-GCM ile şifrelenir. Asla tarayıcıya geri gönderilmezler; liste yalnızca hangi anahtarların ayarlandığını gösterir; örneğin "1 header: Authorization". Yalnızca bir oturum sunucuya bağlanırken çözülürler. Bir sunucunun eklenmesi, değiştirilmesi, etkinleştirilmesi, devre dışı bırakılması ve kaldırılması denetim günlüğüne kaydedilir.

Ajanlar araçları nasıl alır

Bir oturum başladığında AI CodeOps etkin her uzak sunucuya bağlanır ve araçlarını listeler. Ulaşılamayan bir sunucu atlanır ve oturum onun araçları olmadan çalışır.

  • Araçlar <server>__<tool> biçiminde adlandırılır; örneğin github__create_issue.
  • Bir oturum toplamda en fazla 32 MCP aracı sunabilir.
  • Her ajan adımında bir ajan en fazla 6 tur araç çağrısı yapabilir.
  • Her çağrı 30 saniye sonra zaman aşımına uğrar ve uzun sonuçlar kısaltılır.

Ajanlara ulaşan araçları iki şekilde daraltabilirsiniz.

Ajan bazında

Configure → Agents sayfasında özel bir ajanın MCP tools this agent may use seçimi vardır: None (yeni bir ajan için varsayılan), Only the tools listed veya All tools the workspace allows. Liste için sunucuları, araçları veya server__tool adlarını virgülle ayırarak girin. Bu seçim var olmadan önce kaydedilmiş bir ajan, siz değiştirene kadar her aracı korur.

Çalışma alanı politikasıyla

mcp.invoke eylemi üzerindeki bir politika kuralı server/tool ile eşleşir. Politikanın izin vermediği bir araç ajanlara asla sunulmaz. Örneğin GitHub sunucusundaki tüm silme araçlarını oturumlarınızdan uzak tutmak için:

{ "id": "no-repo-deletes", "action": "mcp.invoke", "resource": "github/delete_*", "decision": "deny" }

mcp.invoke kuralları ask değil, allow veya deny kullanabilir. None güven ayarında MCP araçları, bir kural izin vermedikçe reddedilir.

Sorun giderme

Bir oturum bir sunucunun araçlarını kullanmıyorsa:

  • Sunucunun etkin olduğunu ve bir Remote sunucu olduğunu kontrol edin.
  • URL'nin herkese açık HTTPS olduğunu ve sunucunun yalnızca SSE'yi değil, Streamable HTTP'yi desteklediğini kontrol edin.
  • Başlıkları kontrol edin: süresi dolmuş bir token sunucunun bağlantıyı reddetmesine yol açar.
  • Özel ajanın MCP tools allowed alanını ve çalışma alanı politikanızı kontrol edin.

Sonraki adımlar

Sık sorulan sorular

AI CodeOps'un kendisi bir MCP sunucusu mu?

Evet, bu sayfadan ayrı olarak. MCP sunucusu Claude Code, Cursor veya başka bir MCP istemcisinin çalışma alanınızı kullanmasını sağlar; AI CodeOps MCP sunucusu kılavuzuna bakın. Bu sayfa diğer yönle, yani oturumlarınızın bağlandığı sunucularla ilgilidir.

Oturumlar yerel (stdio) MCP sunucularını başlatır mı?

Hayır. Yerel bir sunucu kaydedebilirsiniz, ancak oturumlar yalnızca HTTPS üzerinden uzak sunuculara bağlanır.

Bir başlığı kaydettikten sonra görebilir miyim?

Hayır. Başlıklar ve ortam değişkenleri depolanırken şifrelenir ve bir daha asla gösterilmez. Liste yalnızca hangi anahtarların ayarlandığını gösterir.

Bu sayfa yardımcı oldu mu?