# MCP sunucuları

> 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.

Kaynak: https://aicodeops.dev/tr/docs/mcp-servers · Son güncelleme: 2026-10-18

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](https://aicodeops.dev/tr/docs/mcp-server).

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

## Uzak ve yerel sunucular

| Tür                       | Ne girersiniz                       | Oturumlar 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şkenleri     | Hayı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:

   ```text
   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](https://aicodeops.dev/tr/docs/audit-logs) 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ı](https://aicodeops.dev/tr/docs/policy-engine) `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:

```json
{ "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

- [Ajanlar ve iş akışları](https://aicodeops.dev/tr/docs/agents)
- [Politika kuralları referansı](https://aicodeops.dev/tr/docs/policy-engine)
- [Bağımlılık denetimi](https://aicodeops.dev/tr/docs/dependency-audit)

## 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.
