Amaç
Yapılandırma: örn. mcp_servers YAML dizisi — name, command+args (stdio) veya url (HTTP/SSE, proje kararı). Env injection: sunucuya hangi env geçirilir; secret’lar dikkatli. Güvenilir kaynak: yalnız kullanıcı eklediği sunucular; rastgele URL kabul etme. agentic-feature-flags ile varsayılan kapalı olabilir.
Kapsam
Dahil
- Başlangıç timeout ve sağlık kontrolü.
- Sunucu çöküşünde yeniden bağlanma (proje kararı).
Hariç
- MCP sunucu implementasyon rehberi.
Kurallar
- Her sunucu için çalışma dizini ve PATH dokümante.
- Ağ tabanlı MCP için TLS ve allowlist (
agentic-threat-model). agentic-mcp-tool-mappingile isim çakışması önlemi.
Kontrol listesi
- Örnek config repoda secret içermiyor mu?
- Bilinmeyen sunucu eklerken onay var mı?
- stdio buffer deadlock senaryosu ele alındı mı?
Hata ve geri dönüş
| Tipik sorun | Kontrol | Sonraki adım |
|---|---|---|
| Server start fail | command path | which / absolute path |
| Protocol uyumsuzluğu | SDK sürümü | Pin version |
İlgili belgeler ve skill'ler
../agentic-mcp-tool-mapping/SKILL.md../agentic-feature-flags/SKILL.md../agentic-offline-airgap-notes/SKILL.md../documantations/ARCHITECTURE_AGENTIC_CLI.md