CCG API Docs / MCP-сервер
MCP-сервер · интеграция

MCP-сервер с нашим API

MCP-сервер даёт любому MCP-клиенту (Claude Code, Codex и другим) инструменты нашего API: текстовый chat с моделями вашего тарифа и list_models. Работает с обоими типами ключей.

Начать настройку Открыть статистику

Поддерживаемые ключи

Инструмент chat использует OpenAI-совместимый текстовый endpoint, поэтому работают и GPT-, и Claude-ключи.

Ваш ключКак подключаетсяBase URLМодель (пример)
GPT (gpt-*)инструменты chat + list_modelshttps://bridge.gptclaudegemini.xyzgpt-5.6-terra
Claude (claude-*)инструменты chat + list_modelshttps://bridge.gptclaudegemini.xyzclaude-sonnet-5
Один ключ — один тип моделей

Ключ видит только модели своего тарифа. Проверить список: GET https://bridge.gptclaudegemini.xyz/v1/models с вашим ключом.

Установка и настройка

Сервер распространяется tarball-архивом с этого домена — npm-аккаунт не нужен, npx ставит его по URL. Требуется Node.js 18+.

  1. Claude Code

    Одна команда:

    Terminal
    claude mcp add ccg -e CCG_API_KEY=sk-xxxxxxxxxx -- npx -y https://docs.gptclaudegemini.xyz/mcp/ccg-mcp.tgz

    Либо добавьте в .mcp.json проекта:

    .mcp.json
    {
  "mcpServers": {
    "ccg": {
      "command": "npx",
      "args": ["-y", "https://docs.gptclaudegemini.xyz/mcp/ccg-mcp.tgz"],
      "env": { "CCG_API_KEY": "sk-xxxxxxxxxx" }
    }
  }
}

  2. Codex

    Добавьте в ~/.codex/config.toml:

    ~/.codex/config.toml
    [mcp_servers.ccg]
command = "npx"
args = ["-y", "https://docs.gptclaudegemini.xyz/mcp/ccg-mcp.tgz"]

[mcp_servers.ccg.env]
CCG_API_KEY = "sk-xxxxxxxxxx"

  3. Любой другой MCP-клиент

    Тип — Stdio (локальный процесс): команда npx, аргументы -y https://docs.gptclaudegemini.xyz/mcp/ccg-mcp.tgz, переменная окружения CCG_API_KEY с вашим ключом.

  4. Проверьте

    Перезапустите клиент и попросите ассистента вызвать инструмент list_models — он вернет модели вашего тарифа.

Инструменты сервера

chat — текстовый запрос к любой модели вашего ключа (GPT или Claude); list_models — список доступных model ID. Ключ передается только через переменную окружения и не попадает в конфиг-файлы клиентов, кроме случаев, когда вы сами вписываете его в JSON.

Выбор модели

Доступные model ID зависят от вашего ключа:

Terminal
curl https://bridge.gptclaudegemini.xyz/v1/models \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

Решение проблем

Invalid API Key / 401
Проверьте, что ключ скопирован целиком и без пробелов, а Base URL указан точно как в таблице выше.
Model Not Found
Запросите список моделей вашего ключа через /v1/models и используйте точный ID из ответа.
Первый запрос упал с 5xx, повтор прошел
При недоступности одного upstream шлюз переключается на резервный, но первая попытка может вернуть ошибку. Повторите запрос.
Клиент не видит сервер
Проверьте, что установлен Node.js 18+ (node --version) и что переменная CCG_API_KEY задана в конфигурации сервера, затем полностью перезапустите клиент.
npx долго стартует при первом запуске
Первый запуск скачивает пакет и зависимости; дальше npx использует кэш. При проблемах очистите кэш: npm cache clean --force.

Статистика и ключ

Статистика открывается на отдельном сервисе. Для поиска используйте полный токен; в интерфейсе отображается только маскированная часть ключа.

Открыть статистику