---
title: "Kodlama agent'ları ve editörler"
description: "Claude Code, Codex, Cursor, VS Code, OpenCode ve Windsurf'ü giriş yaparak veya bir API anahtarıyla TwexAPI MCP sunucusuna bağlayın."
---

Aşağıdaki istemcilerin hepsi Streamable HTTP ile aynı sunucuya, `https://api.twexapi.io/mcp` adresine bağlanır. Çoğu, TwexAPI hesabınızla giriş yapabilir: yalnızca URL'yi eklersiniz ve istemci erişimi onaylamanız için bir tarayıcı açar. İstemci MCP girişini desteklemiyorsa veya anahtar kullanmayı tercih ediyorsanız bir API anahtarı kullanın.

| İstemci | TwexAPI ile giriş | API anahtarı | TwexAPI tarafından test edildi |
| --- | --- | --- | --- |
| [Claude Code](#claude-code) | Evet | Evet | Hayır |
| [Cursor](#cursor) | Evet | Evet | Evet |
| [Codex](#codex) | Evet | Evet | Hayır |
| [VS Code](#vs-code) | Evet | Evet | Hayır |
| [OpenCode](#opencode) | Evet | Evet | Hayır |
| [Windsurf](#windsurf) | Doğrulanmadı | Evet | Hayır |

"Test edildi", girişten bir araç çağrısına kadar tüm akışı o istemciyle çalıştırdığımız anlamına gelir. Diğer giriş yöntemleri, her sağlayıcının belgelediği MCP yetkilendirme desteğine dayanır. Giriş başarısız olursa bir API anahtarı kullanın. Claude.ai, Claude Desktop ve ChatGPT için [MCP sunucusuna genel bakış](/mcp/overview#claude-ai-and-claude-desktop) ve [ChatGPT](/mcp/chatgpt) sayfalarına bakın.

:::tip
  API anahtarlarını commit ettiğiniz yapılandırma dosyalarında değil, ortam değişkenlerinde saklayın. Anahtarı [TwexAPI panelinde](https://twexapi.io/dashboard) oluşturun.
:::

<a id="claude-code"></a>

## Claude Code

Sunucuyu ekleyin:

```bash
claude mcp add --transport http twexapi https://api.twexapi.io/mcp
```

Ardından bir Claude Code oturumunda `/mcp` komutunu çalıştırın, `twexapi`'yi seçin ve tarayıcıda erişimi onaylamak için **Authenticate**'i seçin. Sunucuyu `.mcp.json` ile ekibinizle paylaşmak için `--scope project` ekleyin; her ekip üyesi kendi hesabıyla giriş yapar.

API anahtarı kullanmak için header'ı `.mcp.json` dosyasına koyun. Claude Code, `${TWEXAPI_API_KEY}` değerini ortamınızdan genişletir:

```json
{
  "mcpServers": {
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "${TWEXAPI_API_KEY}"
      }
    }
  }
}
```

<a id="cursor"></a>

## Cursor

`~/.cursor/mcp.json` (tüm projeler) veya `.cursor/mcp.json` (tek proje) dosyasına ekleyin:

```json
{
  "mcpServers": {
    "twexapi": {
      "url": "https://api.twexapi.io/mcp"
    }
  }
}
```

**Settings → MCP** bölümünü açın. Sunucu **Needs authentication** gösterir. **Authenticate**'i seçin, tarayıcıda erişimi onaylayın ve tarayıcının Cursor'ı açmasına izin verin. Sunucu üç etkin araç gösterdiğinde hazırdır.

API anahtarı kullanmak için:

```json
{
  "mcpServers": {
    "twexapi": {
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "${env:TWEXAPI_API_KEY}"
      }
    }
  }
}
```

<a id="codex"></a>

## Codex

Sunucuyu ekleyin ve giriş yapın:

```bash
codex mcp add twexapi --url https://api.twexapi.io/mcp
codex mcp login twexapi
codex mcp list
```

Codex CLI, uygulama ve IDE eklentisi `~/.codex/config.toml` dosyasındaki aynı yapılandırmayı paylaşır:

```toml
[mcp_servers.twexapi]
url = "https://api.twexapi.io/mcp"
```

API anahtarı kullanmak için anahtarı içeren ortam değişkenini belirtin. Codex bunu `Authorization: Bearer` olarak gönderir:

```toml
[mcp_servers.twexapi]
url = "https://api.twexapi.io/mcp"
bearer_token_env_var = "TWEXAPI_API_KEY"
```

<a id="vs-code"></a>

## VS Code

Komut paletinden **MCP: Add Server**'ı çalıştırıp **HTTP**'yi seçin veya `.vscode/mcp.json` dosyasına ekleyin:

```json
{
  "servers": {
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp"
    }
  }
}
```

Sunucuyu başlatın ve tarayıcıda görünen giriş isteğini onaylayın.

API anahtarı kullanmak için VS Code'un anahtarı bir kez sormasına ve güvenli şekilde saklamasına izin verin:

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "twexapi-key",
      "description": "TwexAPI API key",
      "password": true
    }
  ],
  "servers": {
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "${input:twexapi-key}"
      }
    }
  }
}
```

<a id="opencode"></a>

## OpenCode

`opencode.json` dosyasına ekleyin:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "twexapi": {
      "type": "remote",
      "url": "https://api.twexapi.io/mcp"
    }
  }
}
```

OpenCode, sunucunun giriş gerektirdiğini algılar ve tarayıcıyı açar. Açmazsa `opencode mcp auth twexapi` komutunu çalıştırın. Durumu `opencode mcp list` ile kontrol edin ve bağlantı başarısız olursa `opencode mcp debug twexapi` kullanın.

API anahtarı kullanmak için otomatik girişi kapatın:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "twexapi": {
      "type": "remote",
      "url": "https://api.twexapi.io/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:TWEXAPI_API_KEY}"
      }
    }
  }
}
```

<a id="windsurf"></a>

## Windsurf

Windsurf'te girişi henüz doğrulamadık; bu nedenle bir API anahtarı kullanın. `~/.codeium/windsurf/mcp_config.json` dosyasına ekleyin (sürümünüzdeki konumu görmek için bu dosyayı Cascade'in MCP menüsünden açın):

```json
{
  "mcpServers": {
    "twexapi": {
      "serverUrl": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}
```

## Diğer istemciler

MCP yetkilendirmesini (PKCE ve dinamik istemci kaydıyla OAuth 2.1) uygulayan her istemci, yalnızca sunucu URL'si eklenerek giriş yapabilir. Aksi halde API anahtarınızı `x-api-key` header'ıyla veya `Authorization: Bearer YOUR_API_KEY` ile gönderin. Kendi istemcinizi geliştiriyorsanız [MCP istemcileri için OAuth](/mcp/oauth) sayfasına bakın.

## Bağlantıyı kontrol edin

- Sunucu `explore`, `twexapi_request` ve `twexapi_write` araçlarını gösterir. Yazma erişiminiz yoksa `twexapi_write` görünmez.
- Agent'ınızdan şunu isteyin: "TwexAPI explore ile trend uç noktalarını bul." `explore` kredi kullanmadığı için bakiye yüklemeden önce de çalışır.
- Yeni bağlantı [paneldeki](https://twexapi.io/dashboard) **Authorized apps** (yetkili uygulamalar) altında görünür.

| Sorun | Çözüm |
| --- | --- |
| `401` veya "Needs authentication" | İstemcinin girişini yeniden çalıştırın (Claude Code'da `/mcp`, Cursor'da **Authenticate**, `codex mcp login` veya `opencode mcp auth`). |
| Onay sayfası API anahtarı olmadığını söylüyor | Panelde bir anahtar oluşturun ve 10 dakika içinde yeniden **Approve**'u seçin. |
| Onay sayfası kredi olmadığını söylüyor | Bakiye yükleyin ve 10 dakika içinde yeniden **Approve**'u seçin. |
| Araç çağrıları "No credits left on this TwexAPI account" döndürüyor | Panelden bakiye yükleyin. Bağlantının kendisi sorunsuzdur. |
| `twexapi_write` eksik | Salt okunur bağlandınız. Uygulamayı panelde iptal edin ve yazma kutusunu işaretli bırakarak yeniden bağlanın. |

Bir sorunu bildirirken istemcinin adını ve sürümünü, UTC saatini ve görebiliyorsanız `X-Request-Id` yanıt header'ını ekleyin.