MCP

Прокси умеет вызывать удалённые MCP-серверы по HTTPS. Он получает список инструментов, крутит цикл вызовов и возвращает финальный ответ за один ход чата. Он не запускает npx и stdio. Локальные серверы остаются в Cursor, Claude Desktop или в вашем клиенте.

Лимит: до 8 серверов на аккаунт. Только HTTPS; localhost по HTTP разрешён для разработки.

В чате

MCP чата сохраняется на аккаунте. Переключатель Settings → MCP tools не нужен. Он только для API.

Откройте чат
Нажмите MCP в композере
Вставьте JSON Cursor / Claude или заполните имя, URL https:// и необязательный bearer-токен
Оставьте сервер On и отправьте обычное сообщение

JSON Cursor / Claude Desktop подходит. Если запись — npx mcp-remote, прокси читает HTTPS URL и заголовок Authorization из args. Поле url у хостинга проще.

{
  "mcpServers": {
    "wiki": {
      "url": "https://mcp.example.com/mcp",
      "headers": { "Authorization": "Bearer your-mcp-token" }
    }
  }
}

{
  "mcpServers": {
    "wiki": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.example.com/mcp",
        "--header",
        "Authorization:Bearer your-mcp-token"
      ]
    }
  }
}

Через API

Включите MCP tools в настройках. Пока это выключено, /v1/chat/completions MCP не смотрит.

Дальше либо передайте серверы в запросе, либо используйте серверы, сохранённые в чате.

curl https://api.proxy.gonka.gg/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -d '{
    "model": "MiniMaxAI/MiniMax-M2.7",
    "messages": [{"role": "user", "content": "Search our wiki for escrow rotation"}],
    "tools": [{
      "type": "mcp",
      "server_label": "wiki",
      "server_url": "https://mcp.example.com/mcp",
      "authorization": "your-mcp-token",
      "allowed_tools": ["search"]
    }]
  }'

Сохранённые серверы — отправьте "mcp": true:

curl https://api.proxy.gonka.gg/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -d '{
    "model": "MiniMaxAI/MiniMax-M2.7",
    "mcp": true,
    "messages": [{"role": "user", "content": "What is open on the wiki?"}]
  }'

Python: неизвестные типы инструментов кладите в extra_body.

response = client.chat.completions.create(
    model="MiniMaxAI/MiniMax-M2.7",
    messages=[{"role": "user", "content": "Search our wiki for escrow rotation"}],
    extra_body={
        "tools": [{
            "type": "mcp",
            "server_label": "wiki",
            "server_url": "https://mcp.example.com/mcp",
            "authorization": "your-mcp-token",
        }]
    },
)

Управление серверами через API

Эти маршруты работают, даже если Settings → MCP tools выключен. Настройка только открывает исполнение на /v1/chat/completions.

Метод	Путь	Назначение
GET	`/v1/mcp/servers`	Список сохранённых серверов (токен не возвращается)
POST	`/v1/mcp/servers`	Добавить `name`, `url`, необязательный `auth_token`
PATCH	`/v1/mcp/servers/{id}`	Обновить имя, URL, токен или `enabled`
DELETE	`/v1/mcp/servers/{id}`	Удалить сервер
GET	`/v1/mcp/tools`	Узнать инструменты включённых серверов
POST	`/v1/mcp/call`	Вызвать один инструмент по полному имени, например `mcp_wiki_search`
POST	`/v1/mcp/resolve`	Разобрать вставленный JSON Cursor / Claude

curl https://api.proxy.gonka.gg/v1/mcp/servers \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "wiki",
    "url": "https://mcp.example.com/mcp",
    "auth_token": "your-mcp-token"
  }'