2026-04-10 23:20:41 -04:00
---
layout: default
title: "MCP Aracı ı ı ı
parent: "Turkish (Beta)"
---
2026-04-11 01:08:44 +00:00
# MCP Aracı ı ı ı
2026-04-10 23:20:41 -04:00
> **Beta Translation:** This document was translated via Machine Learning and as such may not be 100% accurate. All non-English languages are currently classified as Beta.
2026-04-11 01:08:44 +00:00
> **⚠️ ÖNEMLİ: YALNIZCA TEK-KİRACI (SINGLE-TENANT) ORTAMLAR İÇİN**
>
> Bu belirtim, MCP araçları ı ı ı ı ı
> - Çok kullanı ı ı
> - Çok kiracı ı ı ı
> - Federasyonlu doğrulama
> - Kullanı ı ı ı ı ı
> - Kullanı ı ı
>
> Bu özellik, her MCP aracı ı ı ı ı ı ı ı ı ı ı
## Genel Bakı
**Özellik Adı ı ı ı ı
**Yazar**: Claude Code Assistant
**Tarih**: 2025-11-11
**Durum**: Geliştirme Aşaması
### Yönetici Özeti
MCP araçları ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı
**ÖNEMLİ**: Bu, tek kiracı ı ı ı ı ı ı **UYGUN DEĞİL** :
Farklı ı ı ı ı ı ı ı
Kiracı ı ı ı ı ı
Federasyonlu doğrulama senaryoları
Kullanı ı
Dinamik kimlik bilgisi yönetimi veya token yenileme
Bu özellik, her MCP aracı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı
### Sorun Tanı ı
Şu anda, MCP araçları ı ı ı ı ı ı ı ı ı ı ı ı ı
MCP araçları ı
Kullanı ı ı ı ı ı ı
MCP bağlantı ı
MCP uç noktaları ı
### Hedefler
[ ] MCP araç yapı ı ı ı ı `auth-token` parametresini belirtmesine izin verin
[ ] MCP araç hizmetini, MCP sunucuları ı ı ı ı ı
[ ] CLI araçları ı ı ı
[ ] Kimlik doğrulaması ı ı ı
[ ] Token depolama için güvenlik hususları ı
### Hedef Dı ı
Dinamik token yenileme veya OAuth akı ı ı
Depolanmı ı ı ı ı ı ı
Alternatif doğrulama yöntemleri (Temel kimlik doğrulama, API anahtarları
Token doğrulama veya son kullanma kontrolü
**Kullanı ı ı ı ı
**Kiracı ı ı
**Federasyonlu doğrulama**: Bu özellik, kimlik sağlayı ı ı
**Bağlama duyarlı ı ı ı
## Arka Plan ve Bağlam
### Mevcut Durum
MCP araç yapı ı ı `mcp` yapı ı ı ı ı
```json
{
"remote-name": "tool_name",
"url": "http://mcp-server:3000/api"
}
```
MCP aracı `streamablehttp_client(url)` kullanarak sunuculara bağlanı ı ı
### Sı ı
**Mevcut Sistem Sı ı ı
1. **Kimlik doğrulama desteği yok:** Güvenli MCP sunucuları ı
2. **Güvenlik açı ı MCP sunucuları ı ı ı ı
3. **Üretim dağı ı ı API uç noktaları ı ı
**Bu Çözümün Sı ı ı
1. **Yalnı ı Her MCP aracı ı ı ı ı ı
2. **Kullanı ı ı Farklı ı ı ı ı ı ı ı
3. **Çok kiracı ı Kimlik bilgilerini kiracı ı
4. **Yalnı Belirteç yenileme, döndürme veya son kullanma süresi yönetimi desteği yoktur.
5. **Hizmet seviyesi kimlik doğrulaması Bireysel kullanı ı
6. **Paylaşı ı Bir MCP aracı ı ı ı ı ı
### Kullanı ı
**✅ Uygun Kullanı ı
Tek kiracı ı ı ı ı
Hizmetten hizmete kimlik doğrulama (TrustGraph → MCP Sunucusu)
Geliştirme ve test ortamları
TrustGraph sistemi tarafı ı
Tüm kullanı ı ı ı ı ı ı
Statik, uzun ömürlü hizmet kimlik bilgileri
**❌ Uygun Olmayan Kullanı ı
Kullanı ı ı ı ı ı
Kiracı ı ı ı ı ı
Federasyon kimlik doğrulama senaryoları
MCP sunucuları ı ı ı ı
Dinamik belirteç yenileme veya kı
Farklı ı ı ı ı
Kullanı ı
**Örnek Uygun Senaryo:**
Tüm çalı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı
**Örnek Uygun Olmayan Senaryo:**
Kiracı ı ı ı ı ı ı ı
### İlgili Bileşenler
**trustgraph-flow/trustgraph/agent/mcp_tool/service.py**: MCP aracı ı
**trustgraph-cli/trustgraph/cli/set_mcp_tool.py**: MCP yapı ı ı ı ı
**trustgraph-cli/trustgraph/cli/show_mcp_tools.py**: MCP yapı ı ı ı ı
**MCP Python SDK**: `streamablehttp_client` from `mcp.client.streamable_http`
## Gereksinimler
### Fonksiyonel Gereksinimler
1. **MCP Yapı ı : MCP aracı ı ı ı ı `auth-token` alanı
2. **Bearer Belirteç Kullanı ı : MCP aracı ı ı ı ı ı `Authorization: Bearer {token}` başlı ı ı
3. **CLI Desteği** : `tg-set-mcp-tool` , isteğe bağlı `--auth-token` parametresi KABUL ETMELİDİR.
4. **Belirteç Görüntüleme** : `tg-show-mcp-tools` , kimlik doğrulama belirtecinin yapı ı ı ı ı ı
5. **Geriye Dönük Uyumluluk** : Kimlik doğrulama belirteci olmayan mevcut MCP aracı ı ı ı ı
### Fonksiyonel Olmayan Gereksinimler
1. **Geriye Dönük Uyumluluk** : Mevcut MCP aracı ı ı ı ı ı
2. **Performans** : MCP aracı ı ı ı ı
3. **Güvenlik** : Belirteçler yapı ı ı
### Kullanı ı
1. Bir **DevOps mühendisi** olarak, MCP sunucusu uç noktaları ı ı ı ı ı ı ı ı
2. Bir **CLI kullanı ı ı olarak, korumalı ı
3. Bir **sistem yöneticisi** olarak, hangi MCP araçları ı ı ı ı ı ı ı ı ı ı ı
## Tasarı
### Yüksek Seviyeli Mimari
Taşı ı ı ı ı ı ı ı ı
1. MCP aracı ı ı ı ı `auth-token` alanı
2. Kimlik doğrulama belirteci yapı ı ı ı ı ı ı
3. Kimlik doğrulama belirteçleri ayarlamak ve görüntülemek için CLI araçları ı
4. Güvenlik hususları ı ı
### Yapı ı ı
**Mevcut Şema**:
```json
{
"remote-name": "tool_name",
"url": "http://mcp-server:3000/api"
}
```
**Yeni Şema** (isteğe bağlı
```json
{
"remote-name": "tool_name",
"url": "http://mcp-server:3000/api",
"auth-token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
```
**Alan Açı ı
`remote-name` (isteğe bağlı ı ı ı ı ı ı
`url` (gerekli): MCP sunucusu uç noktası
`auth-token` (isteğe bağlı ı ı ı ı
### Veri Akı ı
1. **Yapı ı : Kullanı ı `tg-set-mcp-tool --id my-tool --tool-url http://server/api --auth-token xyz123` 'ı ı ı ı
2. **Yapı ı : MCP aracı `on_mcp_config()` geri çağı ı ı ı ı ı ı ı
3. **Araç Çağrı ı : Araç çağrı ı ı
Hizmet, yapı ı `auth-token` 'ı
Başlı `{"Authorization": "Bearer {token}"}`
Başlı ı `streamablehttp_client(url, headers=headers)` 'a iletir
MCP sunucusu belirteci doğrular ve isteği işler
### API Değişiklikleri
Harici API değişiklikleri yok - yalnı ı ı ı ı ı
### Bileşen Detayları
#### Bileşen 1: service.py (MCP Aracı
**Dosya**: `trustgraph-flow/trustgraph/agent/mcp_tool/service.py`
**Amaç**: Uzak sunuculardaki MCP araçları ı ı
**Gerekli Değişiklikler** (`invoke_tool()` yönteminde):
1. `auth-token` 'ı `self.mcp_services[name]` yapı ı ı ı ı ı
2. Belirteç varsa, Authorization başlı ı ı
3. Başlı ı `streamablehttp_client(url, headers=headers)` 'a iletin
**Mevcut Kod** (42-89 satı ı
```python
async def invoke_tool(self, name, parameters):
try:
if name not in self.mcp_services:
raise RuntimeError(f"MCP service {name} not known")
if "url" not in self.mcp_services[name]:
raise RuntimeError(f"MCP service {name} URL not defined")
url = self.mcp_services[name]["url"]
if "remote-name" in self.mcp_services[name]:
remote_name = self.mcp_services[name]["remote-name"]
else:
remote_name = name
logger.info(f"Invoking {remote_name} at {url}")
# Connect to a streamable HTTP server
async with streamablehttp_client(url) as (
read_stream,
write_stream,
_,
):
# ... rest of method
```
**Değiştirilmiş Kod:**
```python
async def invoke_tool(self, name, parameters):
try:
if name not in self.mcp_services:
raise RuntimeError(f"MCP service {name} not known")
if "url" not in self.mcp_services[name]:
raise RuntimeError(f"MCP service {name} URL not defined")
url = self.mcp_services[name]["url"]
if "remote-name" in self.mcp_services[name]:
remote_name = self.mcp_services[name]["remote-name"]
else:
remote_name = name
# Build headers with optional bearer token
headers = {}
if "auth-token" in self.mcp_services[name]:
token = self.mcp_services[name]["auth-token"]
headers["Authorization"] = f"Bearer {token}"
logger.info(f"Invoking {remote_name} at {url}")
# Connect to a streamable HTTP server with headers
async with streamablehttp_client(url, headers=headers) as (
read_stream,
write_stream,
_,
):
# ... rest of method (unchanged)
```
#### Bileşen 2: set_mcp_tool.py (CLI Yapı ı ı
**Dosya**: `trustgraph-cli/trustgraph/cli/set_mcp_tool.py`
**Amaç**: MCP aracı ı ı ı ı
**Gerekli Değişiklikler**:
1. `--auth-token` isteğe bağlı ı
2. Sağlandı ı `auth-token` 'yi yapı ı
**Mevcut Argümanlar**:
`--id` (gerekli): MCP aracı ı ı ı ı
`--remote-name` (isteğe bağlı ı ı
`--tool-url` (gerekli): MCP aracı ı
`-u, --api-url` (isteğe bağlı
**Yeni Argüman**:
`--auth-token` (isteğe bağlı ı ı ı
**Değiştirilmiş Yapı ı
```python
# Build configuration object
config = {
"url": args.tool_url,
}
if args.remote_name:
config["remote-name"] = args.remote_name
if args.auth_token:
config["auth-token"] = args.auth_token
# Store configuration
api.config().put([
ConfigValue(type="mcp", key=args.id, value=json.dumps(config))
])
```
#### Bileşen 3: show_mcp_tools.py (CLI Görüntüleme Aracı
**Dosya**: `trustgraph-cli/trustgraph/cli/show_mcp_tools.py`
**Amaç**: MCP araç yapı ı ı ı
**Gerekli Değişiklikler**:
1. Çı ı
2. "auth-token" varlı ı ı ı
3. Gerçek token değerini görüntülemeyin (güvenlik)
**Mevcut Çı ı
```
ID Remote Name URL
---------- ------------- ------------------------
my-tool my-tool http://server:3000/api
```
**Yeni Çı ı
```
ID Remote Name URL Auth
---------- ------------- ------------------------ ------
my-tool my-tool http://server:3000/api Yes
other-tool other-tool http://other:3000/api No
```
#### Bileşen 4: Belgeler
**Dosya**: `docs/cli/tg-set-mcp-tool.md`
**Gerekli Değişiklikler**:
1. Yeni `--auth-token` parametresini belgeleyin
2. Kimlik doğrulama ile örnek kullanı ı
3. Güvenlik hususları ı
## Uygulama Planı
### Aşama 1: Teknik Özellikleri Oluşturma
[x] Tüm değişiklikleri belgeleyen kapsamlı ı
### Aşama 2: MCP Araç Hizmetini Güncelleme
[ ] `service.py` içindeki `invoke_tool()` 'ı ı ı ı
[ ] Başlı `streamablehttp_client` 'a iletin
[ ] Kimliği doğrulanmı
### Aşama 3: CLI Araçları ı
[ ] `set_mcp_tool.py` 'e `--auth-token` argümanı ı
[ ] auth-token'ı ı ı
[ ] `show_mcp_tools.py` çı ı ı
[ ] CLI araç değişikliklerini test edin
### Aşama 4: Belgeleri Güncelleme
[ ] `tg-set-mcp-tool.md` içindeki `--auth-token` parametresini belgeleyin
[ ] Güvenlik hususları
[ ] Örnek kullanı ı
### Aşama 5: Test
[ ] MCP aracı ı ı ı ı ı
[ ] Geriye dönük uyumluluğu test edin (auth-token olmadan çalı
[ ] CLI araçları ı ı ı ı ı
[ ] "show" komutunun auth durumunu doğru şekilde gösterdiğini test edin
### Kod Değişiklikleri Özeti
| Dosya | Değişiklik Türü | Satı ı
|------|------------|-------|-------------|
| `service.py` | Değiştirildi | ~52-66 | auth-token okuma ve başlı
| `set_mcp_tool.py` | Değiştirildi | ~30-60 | --auth-token argümanı ı ı
| `show_mcp_tools.py` | Değiştirildi | ~40-70 | Görüntüleme için "Auth" sütununu ekleyin |
| `tg-set-mcp-tool.md` | Değiştirildi | Çeşitli | Yeni parametreyi belgeleyin |
## Test Stratejisi
### Birim Testleri
**Auth Token Okuma**: `invoke_tool()` 'ı ı ı ı
**Başlı ı ı ı
**Geriye Dönük Uyumluluk**: auth-token olmadan çalı ı ı ı ı ı
**CLI Argümanı ı ı `--auth-token` argümanı ı ı ı ı ı ı ı
### Entegrasyon Testleri
**Kimliği Doğrulanmı ı ı ı ı ı
**Uçtan Uca**: CLI → yapı ı ı ı ı
**Token Gerekli Değil**: Kimliği doğrulanmamı ı ı ı ı ı ı
### Manuel Testler
**Gerçek MCP Sunucusu**: bearer token kimlik doğrulaması
**CLI İş Akı ı ı ı ı ı ı ı ı ı ı ı ı
**Görüntü Maskeleme**: auth durumunun gösterildiğini ancak token değerinin görünmediğini doğrulayı
## Göç ve Dağı ı
### Göç Stratejisi
Göç gerektirmez - bu tamamen ek bir işlevsellik:
`auth-token` içermeyen mevcut MCP araç yapı ı ı ı
Yeni yapı ı ı `auth-token` alanı ı
CLI araçları `--auth-token` parametresini kabul eder, ancak gerektirmez
### Dağı ı ı
1. **Aşama 1** : Temel hizmet değişikliklerini geliştirme/hazı ı ı ı ı
2. **Aşama 2** : CLI araç güncellemelerini dağı ı
3. **Aşama 3** : Belgeleri güncelleyin
4. **Aşama 4** : İzleme ile üretim dağı ı ı
### Geri Alma Planı
Temel değişiklikler geriye dönük uyumludur - mevcut araçlar etkilenmez
Sorunlar ortaya çı ı ı ı ı ı ı ı ı ı
CLI değişiklikleri bağı ı ı ı ı
## Güvenlik Hususları
### ⚠️ Kritik Sı ı ı ı ı
**Bu kimlik doğrulama mekanizması ı ı ı ı ı
**Paylaşı ı ı ı ı ı ı ı
**Kullanı ı ı ı ı ı ı ı ı
**Kiracı ı ı ı ı ı ı ı
**Denetim izi sı ı ı ı
**İzin kapsamı ı ı ı ı
**Bu özelliği KULLANMAYIN eğer:**
TrustGraph dağı ı ı ı ı ı
Hangi kullanı ı ı ı
Farklı ı ı ı ı ı
Kullanı ı ı
MCP sunucunuz kullanı ı ı ı ı ı ı ı
**Çok kullanı ı ı ı ı
Özel başlı ı ı ı ı ı ı ı ı ı ı ı
Her kiracı ı ı ı
Ağ seviyesinde izolasyon kullanı ı
Her kullanı ı ı ı
### Token Depolama
**Risk**: Kimlik doğrulama jetonları ı ı ı
**Giderilmesi Gereken Durum:**
Jetonları ı ı ı
Mümkün olduğunda kı ı ı
Yapı ı ı ı ı
Şifrelenmiş jeton depolama için gelecekteki bir iyileştirmeyi düşünün
### Jetonun Açı ı ı ı
**Risk**: Jetonlar günlüklerde veya CLI çı ı ı ı ı
**Giderilmesi Gereken Durum:**
Jeton değerlerini kaydetmeyin (sadece "kimlik doğrulama yapı ı ı ı ı ı ı
CLI göster komutu yalnı
Jetonları ı
### Ağ Güvenliği
**Risk**: Jetonlar şifrelenmemiş bağlantı
**Giderilmesi Gereken Durum:**
MCP sunucuları ı ı
HTTP ile düz metin iletim riskine ilişkin kullanı ı ı
### Yapı ı
**Risk**: Yapı ı ı ı ı ı
**Giderilmesi Gereken Durum:**
Yapı ı
Yapı ı ı ı
Yapı ı ı
### Çok Kullanı ı ı
**Risk**: Çok kullanı ı ı ı ı ı ı ı ı
**Riskin Anlaşı ı
Kullanı ı ı ı ı ı ı ı ı
MCP sunucusu, farklı ı ı ı ı ı
Kullanı ı ı ı ı ı ı ı ı
MCP sunucusundaki denetim günlükleri, aynı
Bir kullanı ı ı ı ı ı ı ı ı
**Bu bir hata DEĞİLDİR - bu tasarı ı ı ı ı ı
## Performans Etkisi
**Minimum ek yük**: Başlı
**Ağ etkisi**: Ek HTTP başlı ı ı ı
**Bellek kullanı ı ı ı ı
## Belgeler
### Kullanı ı
[ ] `tg-set-mcp-tool.md` 'ı `--auth-token` parametresiyle güncelleyin
[ ] Güvenlik hususları
[ ] Bir örnek kullanı ı ı ı ı
[ ] Jeton depolama etkilerini belgeleyin
### Geliştirici Belgeleri
[ ] `service.py` içindeki kimlik doğrulama jetonu işleme için satı
[ ] Başlı ı ı ı
[ ] MCP aracı ı ı ı
## Açı
1. **Jeton şifreleme** : Yapı ı ı ı ı ı
2. **Jeton yenileme** : OAuth yenileme akı ı
3. **Alternatif kimlik doğrulama yöntemleri** : Temel kimlik doğrulama, API anahtarları
## Değerlendirilen Alternatifler
1. **Jetonlar için ortam değişkenleri** : Jetonları ı ı ı
**Reddedildi** : Dağı ı ı ı ı ı ı ı
2. **Ayrı : Özel bir gizli anahtar yönetim sistemi kullanı
**Erteleme** : Başlangı ı ı ı ı ı
3. **Çoklu kimlik doğrulama yöntemleri** : Temel, API anahtarı
**Reddedildi** : Taşı ı ı ı ı ı ı
4. **Şifrelenmiş jeton depolama** : Jetonları ı ı
**Erteleme** : Yapı ı ı ı ı
5. **Her çağrı : Jetonları ı ı
**Reddedildi** : Endişe ayrı ı ı ı ı
## Referanslar
[MCP Protokolü Özellikleri ](https://github.com/modelcontextprotocol/spec )
[HTTP Taşı ı ı ı ](https://tools.ietf.org/html/rfc6750 )
[Mevcut MCP Aracı ](../trustgraph-flow/trustgraph/agent/mcp_tool/service.py )
[MCP Aracı ı ](./mcp-tool-arguments.md )
## Ek
### Örnek Kullanı
**Kimlik doğrulama ile MCP aracı ı ı ı ı ı
```bash
tg-set-mcp-tool \
--id secure-tool \
--tool-url https://secure-server.example.com/mcp \
--auth-token eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
```
**MCP araçları ı
```bash
tg-show-mcp-tools
ID Remote Name URL Auth
----------- ----------- ------------------------------------ ------
secure-tool secure-tool https://secure-server.example.com/mcp Yes
public-tool public-tool http://localhost:3000/mcp No
```
### Yapı ı
**Yapı ı ı
```json
{
"type": "mcp",
"key": "secure-tool",
"value": "{\"url\": \"https://secure-server.example.com/mcp\", \"auth-token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\"}"
}
```
### Güvenlik En İyi Uygulamaları
1. **HTTPS Kullanı ı : Kimlik doğrulama ile çalı ı ı
2. **Kı : Mümkün olduğunda, son kullanma tarihine sahip token'lar kullanı
3. **En Az Yetki** : Token'lara, yalnı
4. **Erişim Kontrolü** : Yapı ı ı ı ı
5. **Token Döndürme** : Token'ları
6. **Denetim Kayı ı : Güvenlik olayları ı ı
