Используй сервер MCP

Сервер MCP Caputchin позволяет ИИ-агенту (Claude, Cursor или любому клиенту Model Context Protocol) управлять твоим аккаунтом, вызывая тот же API управления, что использует панель. Сервер это тонкая оболочка транспорта и аутентификации: он выставляет один инструмент MCP на каждую операцию управления и проксирует каждый вызов в API. Так что агент может делать всё, что можешь ты, кроме оплаты, на естественном языке.

Выпусти токен доступа

Сервер аутентифицируется токеном доступа из переменной окружения CAPUTCHIN_TOKEN. Любой вид работает (смотри аутентификацию API):

• персональный токен доступа для контроля над всем аккаунтом, или
• токен доступа команды, чтобы ограничить агента определёнными командами с наименьшими привилегиями, что является более безопасным умолчанием при передаче доступа автономному агенту.

Скопируй токен при создании; он показывается один раз.

Два способа подключиться

Есть два транспорта, и они выставляют те же инструменты, опирающиеся на тот же API управления. Выбирай по тому, как подключается твой клиент:

Локальный: npx-сервер (stdio)

Сервер опубликован как @caputchin/mcp в npm. Обычно ты не запускаешь его вручную; ты прописываешь его в конфиг своего MCP-клиента, и он порождается через stdio, с токеном в своём окружении:

{
  "mcpServers": {
    "caputchin": {
      "command": "npx",
      "args": ["-y", "@caputchin/mcp"],
      "env": { "CAPUTCHIN_TOKEN": "cpt_pat_..." }
    }
  }
}

Чтобы проверить, что он работает, запусти его напрямую; он говорит на MCP через stdio и выходит с ошибкой, если токен отсутствует:

CAPUTCHIN_TOKEN=cpt_pat_... npx -y @caputchin/mcp

Размещённый: HTTP-эндпоинт

Для клиентов, которые подключаются к удалённому серверу MCP вместо порождения локального, Caputchin размещает тот же сервер по адресу:

https://caputchin.com/api/mcp

Он аутентифицируется твоим токеном как заголовком Bearer на соединении (те же учётные данные, просто переданные по HTTP, а не через окружение):

{
  "mcpServers": {
    "caputchin": {
      "url": "https://caputchin.com/api/mcp",
      "headers": { "Authorization": "Bearer cpt_pat_..." }
    }
  }
}

Точная форма конфига зависит от твоего MCP-клиента; важны URL и заголовок Authorization: Bearer. Устанавливать нечего, и нет локального процесса; компромисс в том, что токен путешествует к размещённому эндпоинту на каждый запрос, а не остаётся в окружении локального процесса.

Инструменты

Каждый инструмент назван caputchin_<verb>_<noun> и отображается на одну операцию управления, например caputchin_list_troops, caputchin_create_site, caputchin_rotate_site_secret, caputchin_add_troop_member, caputchin_site_stats. Агент обнаруживает полный набор и параметры каждого инструмента автоматически через MCP, так что ты описываешь цель, а агент выбирает инструменты.

Разобранный пример

С сервером, прописанным в твой клиент, ты можешь попросить агента простым языком:

«Создай ключ сайта под именем shop-frontend в моей команде shop-team, затем включи для него игровые ворота.»

Агент разрешает это в последовательность вызовов инструментов: caputchin_list_troops, чтобы найти id команды, caputchin_create_site с этим troop_id, затем caputchin_update_site_security, чтобы потребовать игру. Каждый вызов бьёт в API управления под твоим токеном, и на Apex каждый приземляется в твоём журнале аудита, приписанный токену, так что действия агента так же отслеживаемы, как и человека.

Поскольку агент действует с полной досягаемостью твоего токена, предпочитай токен команды с охватом, когда можешь, и отзови его в тот же момент, как задача сделана.

Полный справочник

Для полного списка инструментов, каждого с однострочным описанием и правом, которое должен держать его токен, смотри справочник инструментов MCP. Инструменты зеркалят API управления один в один, так что интерактивный справочник API это авторитетное описание параметров и ответа каждой операции: читай MCP-описание инструмента для сводки, обращённой к агенту, и справочник API для точной схемы.

См. также

• Справочник инструментов MCP: каждый инструмент, его описание и нужное ему право.
• Управляй Caputchin через API: HTTP API, который вызывает каждый инструмент.
• Используй Terraform или OpenTofu: поверхность infrastructure-as-code.
• Персональный токен доступа и токены команды: учётные данные, которые использует сервер.