> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# TokenLab MCP Server

> MCP istemcilerini TokenLab model keşfine, fiyatlandırmasına, OpenAI uyumlu sohbete ve yerel çıkarım uç noktalarına bağlayın.

[TokenLab MCP sunucusu](https://github.com/hedging8563/tokenlab-mcp-server), MCP uyumlu ajanlara canlı model keşfi, fiyatlandırma, OpenAI uyumlu Chat Completions ve yerel çıkarım araçları sunar.

Bunu, bir ajanın modelleri karşılaştırması, istek formatlarını incelemesi, fiyatları kontrol etmesi veya TokenLab'i OpenAI Chat Completions, Responses, Anthropic Messages ya da Gemini generateContent ile çağırması gerektiğinde kullanın.

<Note>
  Genel katalog araçları TokenLab API anahtarı gerektirmez. Dört ücretli çıkarım aracını kullanmak için `TOKENLAB_API_KEY` ayarlayın.
</Note>

## Sağladığı Özellikler

* `https://api.tokenlab.sh/v1/models` adresinden canlı model keşfi.
* `/v1/models/{model}` üzerinden model detay sorgulama.
* `/v1/models/{model}/pricing` üzerinden fiyatlandırma sorgulama.
* `https://api.tokenlab.sh/llms.txt` adresinden ajan tarafından okunabilir API genel bakışı.
* OpenAI uyumlu sohbet, Responses, Anthropic Messages, Gemini, medya, ses, yerleştirmeler (embeddings), yeniden sıralama (rerank) ve çeviri için uç nokta ailesi rehberliği.
* OpenAI uyumlu Chat Completions, Responses, Anthropic Messages ve Gemini generateContent üzerinden isteğe bağlı çıkarım.

## GitHub'dan Kurulum

Genel depoyu klonlayın ve bağımlılıkları yükleyin:

```bash theme={null}
git clone https://github.com/hedging8563/tokenlab-mcp-server.git
cd tokenlab-mcp-server
npm install
npm test
```

Sunucuyu stdio üzerinden başlatın:

```bash theme={null}
npm start
```

İsteğe bağlı `TOKENLAB_API_BASE` ortam değişkeni varsayılan olarak `https://api.tokenlab.sh` değerini alır.

## Codex'e kurulum

Genel katalog sunucusunu Codex yapılandırmanıza ekleyin:

```bash theme={null}
codex mcp add tokenlab-model-catalog -- npx -y @tokenlabai/mcp-server
```

Sunucuyu ekledikten sonra yeni bir Codex oturumu başlatın. Genel katalog araçları `TOKENLAB_API_KEY` gerektirmez.

Çıkarım araçlarını etkinleştirmek için sunucuyu eklerken TokenLab API anahtarınızı belirtin:

```bash theme={null}
codex mcp add --env TOKENLAB_API_KEY=your-tokenlab-api-key tokenlab-model-catalog -- npx -y @tokenlabai/mcp-server
```

## Cline'a kurulum

Yayımlanmış stdio sunucusunu Cline CLI ile kurun:

```bash theme={null}
cline mcp add tokenlab --yes -- npx -y @tokenlabai/mcp-server
```

Komut Cline CLI ile doğrulandı ve kurulum uyarısı olmadan tamamlanıyor. Genel katalog araçları hemen çalışır; çıkarım araçları için Cline ortamında `TOKENLAB_API_KEY` ayarlayın.

## Claude Desktop Yapılandırması

Yayımlanmış npm paketini MCP istemci yapılandırmanıza ekleyin:

```json theme={null}
{
  "mcpServers": {
    "tokenlab-model-catalog": {
      "command": "npx",
      "args": ["-y", "@tokenlabai/mcp-server"]
    }
  }
}
```

Yapılandırmayı kaydettikten sonra MCP istemcisini yeniden başlatın.

## Cursor, Windsurf ve Diğer MCP İstemcileri

Stdio MCP sunucularını destekleyen herhangi bir istemcide aynı komutu ve argümanları kullanın:

```json theme={null}
{
  "command": "npx",
  "args": ["-y", "@tokenlabai/mcp-server"],
  "env": {
    "TOKENLAB_API_BASE": "https://api.tokenlab.sh"
  }
}
```

İstemciniz adlandırılmış sunucuları saklıyorsa, sunucu adı olarak `tokenlab-model-catalog` kullanın.

## Araçlar

| Araç                       | Amaç                                                                                                                                                        |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `list_models`              | Genel TokenLab modellerini listeler. İsteğe bağlı olarak `image`, `video`, `embedding`, `rerank` veya `translation` gibi `recommended_for` ile filtreleyin. |
| `get_model`                | Bir modelin genel detaylarını ve desteklenen istek formatını getirir.                                                                                       |
| `get_model_pricing`        | Bir modelin genel fiyatlandırma detaylarını getirir.                                                                                                        |
| `compare_models`           | Birden fazla model kimliğinin detaylarını ve fiyatlarını karşılaştırır.                                                                                     |
| `create_chat_completion`   | OpenAI uyumlu `/v1/chat/completions` uç noktasını çağırır; çok modlu mesajları ve araç çağrılarını destekler. `TOKENLAB_API_KEY` gerektirir.                |
| `create_response`          | `/v1/responses` uç noktasını çağırır. `TOKENLAB_API_KEY` gerektirir.                                                                                        |
| `create_anthropic_message` | Anthropic Messages `/v1/messages` uç noktasını çağırır. `TOKENLAB_API_KEY` gerektirir.                                                                      |
| `create_gemini_content`    | Gemini yerel `generateContent` uç noktasını çağırır. `TOKENLAB_API_KEY` gerektirir.                                                                         |
| `get_api_overview`         | Ajan tarafından okunabilir uç nokta rehberliği için TokenLab'in `llms.txt` özetini getirir.                                                                 |

Çıkarım araçları normal JSON sonuçları döndürür. MCP araç çağrılarında akış bilinçli olarak devre dışıdır.

## Önerilen Ajan İş Akışı

1. Kullanıcı bir model adı belirtmediğinde `list_models` çağrısı yapın.
2. Sohbet dışı görevler (görüntü, video, müzik, 3D, TTS, STT, yerleştirmeler, yeniden sıralama veya çeviri gibi) için `recommended_for` kullanın.
3. Sohbet dışı bir istek oluşturmadan, başarısız bir isteği yeniden denemeden veya uç nokta ailelerini değiştirmeden önce `get_model` çağrısı yapın.
4. Model maliyeti kullanıcının seçimini etkilediğinde `get_model_pricing` çağrısı yapın.
5. Seçim birden fazla adaya bağlı olduğunda `compare_models` kullanın.
6. Gerekli API sözleşmesine uygun çıkarım aracını çağırın veya TokenLab API ailelerinin kompakt bir haritası için `get_api_overview` kullanın.

## Yerel Uç Nokta Rehberliği

TokenLab, OpenAI uyumlu rotaları ve yerel uç nokta ailelerini destekler. MCP sunucusu, bir ajanın kod yazmadan önce doğru rotayı seçmesine yardımcı olur:

| Aile                               | Yaygın rota                                                              |
| ---------------------------------- | ------------------------------------------------------------------------ |
| OpenAI uyumlu sohbet               | `/v1/chat/completions`                                                   |
| Responses                          | `/v1/responses`                                                          |
| Anthropic Messages                 | `/v1/messages`                                                           |
| Gemini yerel                       | `/v1beta/models/{model}:generateContent`                                 |
| Görüntüler                         | `/v1/images/generations`, `/v1/images/edits`                             |
| Video                              | `/v1/videos/generations`                                                 |
| Müzik                              | `/v1/music/generations`                                                  |
| 3D                                 | `/v1/3d/generations`                                                     |
| Ses                                | `/v1/audio/speech`, `/v1/audio/transcriptions`, `/v1/audio/translations` |
| Yerleştirmeler ve yeniden sıralama | `/v1/embeddings`, `/v1/rerank`                                           |
| Metin çevirisi                     | `/v1/translations`                                                       |

## Barındırılan Model Explorer

Streamable HTTP destekleyen istemciler şu adrese bağlanabilir:

```text theme={null}
https://tokenlab-model-explorer.vercel.app/mcp
```

Barındırılan Explorer herkese açıktır ve `open_tokenlab_model_explorer`, `compare_tokenlab_models` ile `generate_tokenlab_endpoint_example` araçlarını sunar. Dokuz aracın tamamı veya kimlik bilgili çıkarım için yukarıdaki yerel npm sunucusunu kullanın.

## TokenLab Yetenekleri (Skills) ile Kullanım

MCP sunucusu çalışma zamanında yararlıdır; [TokenLab yetenekleri deposu](https://github.com/hedging8563/tokenlab-skills) ise kodlama ajanlarına entegrasyon kodunu nasıl oluşturacaklarını ve onaracaklarını öğretir.

Mümkün olduğunda her ikisini de kullanın:

* MCP sunucusu: güncel modelleri, fiyatlandırmayı ve uç nokta detaylarını keşfedin.
* `tokenlab-api-integration` yeteneği: çalıştırılabilir API örnekleri oluşturun ve yapılandırılmış TokenLab hatalarını yönetin.
* `tokenlab-model-picker` yeteneği: kullanıcının görevi için güçlü modeller seçin.
* `tokenlab-native-endpoints` yeteneği: Responses, Anthropic Messages, Gemini, medya, ses, yerleştirme, yeniden sıralama veya çeviri rotalarının ne zaman kullanılacağına karar verin.

## Sorun Giderme

<AccordionGroup>
  <Accordion title="İstemci sunucuyu başlatamıyor">
    Node.js sürümünün en az 18.17 olduğunu doğrulayın ve npm veya ağ hatalarını görmek için terminalde bir kez `npx -y @tokenlabai/mcp-server` çalıştırın.
  </Accordion>

  <Accordion title="Model listesi boş">
    Makinenin `https://api.tokenlab.sh/v1/models` adresine ulaşabildiğini doğrulayın. `TOKENLAB_API_BASE` değerini geçersiz kılıyorsanız, sonunda eğik çizgi (/) olmadığından emin olun.
  </Accordion>

  <Accordion title="Ajan hala eski model kimliklerini seçiyor">
    Ajandan bir model adını sabit kodlamadan (hardcoding) önce `list_models` veya `get_model` çağırmasını isteyin. MCP sunucusunu `tokenlab-model-picker` ile eşleştirmek daha iyi sonuçlar verir.
  </Accordion>

  <Accordion title="Bu sunucu ücretli TokenLab çıkarım API'lerini çağırabilir mi?">
    Evet. `TOKENLAB_API_KEY` ayarlayın ve `create_chat_completion`, `create_response`, `create_anthropic_message` veya `create_gemini_content` kullanın. Katalog ve fiyatlandırma araçları anahtar olmadan kullanılabilir.
  </Accordion>
</AccordionGroup>

## Kaynaklar

<CardGroup cols={2}>
  <Card title="GitHub Deposu" icon="github" href="https://github.com/hedging8563/tokenlab-mcp-server">
    Kaynak kod ve yerel kurulum talimatları
  </Card>

  <Card title="TokenLab Yetenekleri" icon="sparkles" href="https://github.com/hedging8563/tokenlab-skills">
    TokenLab entegrasyonları için bakımı yapılan ajan yetenekleri
  </Card>

  <Card title="Model Kataloğu API" icon="list" href="https://api.tokenlab.sh/v1/models">
    Genel model keşif uç noktası
  </Card>

  <Card title="llms.txt" icon="file-lines" href="https://api.tokenlab.sh/llms.txt">
    Ajan tarafından okunabilir TokenLab API özeti
  </Card>

  <Card title="Glama MCP Sunucusu" icon="globe" href="https://glama.ai/mcp/servers/hedging8563/tokenlab-mcp-server">
    Doğrulanmış TokenLab MCP Server kaydını görüntüleyin
  </Card>

  <Card title="Glama Model Gezgini" icon="search" href="https://glama.ai/mcp/servers/hedging8563/tokenlab-openai-apps-model-explorer">
    Modelleri, fiyatlandırmayı ve yerel uç nokta örneklerini keşfedin
  </Card>

  <Card title="MCP.so Kaydı" icon="compass" href="https://mcp.so/servers/tokenlab-mcp-server">
    TokenLab'i AI & Agents dizininde keşfedin
  </Card>

  <Card title="Barındırılan Model Explorer" icon="rocket" href="https://tokenlab-model-explorer.vercel.app">
    Genel model gezginini ve uzak MCP uç noktasını açın
  </Card>
</CardGroup>