Kodlama agent'ları ve editörler

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.

“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ış ve ChatGPT sayfalarına bakın.

Claude Code

Sunucuyu ekleyin:

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:

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

Cursor

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

{
  "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:

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

Codex

Sunucuyu ekleyin ve giriş yapın:

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:

[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:

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

VS Code

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

{
  "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:

{
  "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}"
      }
    }
  }
}

OpenCode

opencode.json dosyasına ekleyin:

{
  "$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:

{
  "$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}"
      }
    }
  }
}

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):

{
  "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 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 Authorized apps (yetkili uygulamalar) altında görünür.

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.