Быстрый старт MCP

Triggo включает встроенный сервер Model Context Protocol по адресу POST /mcp. Направьте любой MCP-клиент — Claude Desktop, Claude Code, Cursor, Windsurf или свой собственный — на этот эндпоинт с Bearer API-ключом, и клиент сразу обнаружит все 19 инструментов Triggo. Эта страница подробно разбирает пять самых распространённых подключений и перечисляет все инструменты, которые регистрирует сервер.

Что понадобится

Прежде чем начать, нужно три вещи:

1. Аккаунт Triggo хотя бы с одним рабочим пространством. MCP-сервер мультитенантный и привязывает каждый вызов к рабочему пространству, которому принадлежит API-ключ.
2. API-ключ с правами, необходимыми для тех инструментов, которые вы собираетесь вызывать. Как минимум, для сценария «запуск опубликованного действия» ключу нужны actions:read, actions:run и runs:read. О создании ключа см. API-ключи.
3. Хотя бы один опубликованный workflow в рабочем пространстве. Неопубликованные черновики невидимы для инструментов list_actions / run_action. См. Публикацию workflow как действий для процесса публикации.

Транспорт и эндпоинт

Сервер говорит на JSON-RPC поверх Streamable HTTP. Один HTTP POST на MCP-сообщение, тела запроса и ответа — конверты JSON-RPC:

• Эндпоинт: POST https://api.triggo.dev/mcp
• Аутентификация: Authorization: Bearer trg_... — тот же формат ключа, что и у runtime REST API. Принимаются и Bearer API-ключи, и OAuth access-токены (от OIDC-провайдера Better Auth).
• Тип контента: application/json
• Лимиты: скользящее окно по ключу, с учётом тарифа. Ответ 429 содержит заголовок retry-after в секундах; любой ответ несёт x-ratelimit-limit, x-ratelimit-remaining и x-ratelimit-reset (epoch-секунды).

Текущая сборка поднимает свежий MCP-сервер на каждый HTTP-запрос, поэтому с точки зрения клиента сессии отсутствуют: нет handshake по session-id, и каждый POST самодостаточен. Если вы встраиваете sessions-aware транспорт Streamable HTTP из MCP SDK, он будет работать — сервер просто не требует потока с session-id.

Идентификация сервера (возвращается в handshake MCP initialize): имя triggo-runtime, версия 1.0.0, capabilities { tools, resources, prompts }.

Claude Desktop

Откройте ~/Library/Application Support/Claude/claude_desktop_config.json на macOS или %APPDATA%\Claude\claude_desktop_config.json на Windows и добавьте:

{
  "mcpServers": {
    "triggo-runtime": {
      "url": "https://api.triggo.dev/mcp",
      "headers": {
        "Authorization": "Bearer trg_YOUR_API_KEY"
      }
    }
  }
}

Перезапустите Claude Desktop. Инструменты Triggo появятся под иконкой «plug» в композере. Если ваша сборка Claude Desktop ещё не поддерживает URL-based MCP-серверы (старые релизы требовали stdio-транспорт через процесс), используйте мост mcp-remote:

{
  "mcpServers": {
    "triggo-runtime": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.triggo.dev/mcp",
        "--header",
        "Authorization: Bearer trg_YOUR_API_KEY"
      ]
    }
  }
}

mcp-remote терминирует Streamable HTTP локально и переотдаёт его в Claude Desktop по stdio. Предпочитайте URL-форму, где она поддерживается, — там на одно звено меньше.

Claude Code

Добавьте в .claude/settings.json проекта (или в пользовательский ~/.claude/settings.json для глобального доступа):

{
  "mcpServers": {
    "triggo-runtime": {
      "type": "url",
      "url": "https://api.triggo.dev/mcp",
      "headers": {
        "Authorization": "Bearer trg_YOUR_API_KEY"
      }
    }
  }
}

Явный "type": "url" говорит Claude Code открыть транспорт Streamable HTTP, а не запускать подпроцесс. Затем выполните claude mcp list в терминале, чтобы убедиться, что Triggo виден с 19 инструментами.

Cursor

Откройте Cursor Settings → Features → Model Context Protocol или отредактируйте ~/.cursor/mcp.json напрямую:

{
  "mcpServers": {
    "triggo-runtime": {
      "url": "https://api.triggo.dev/mcp",
      "headers": {
        "Authorization": "Bearer trg_YOUR_API_KEY"
      }
    }
  }
}

Переоткройте панель чата Cursor. На бейдже инструментов должно быть triggo-runtime (19).

Произвольный MCP-клиент

С эндпоинтом может говорить любой HTTP-клиент, умеющий POST'ить JSON с Bearer-заголовком. Вот минимальный вызов tools/list через curl:

curl -sS https://api.triggo.dev/mcp \
  -H "Authorization: Bearer trg_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Вы получите JSON-RPC-конверт с массивом result.tools. Дальше — обычный поток MCP: initialize для согласования версии протокола, tools/list для перечисления, tools/call для вызова с { "name": "list_actions", "arguments": { "status": "active" } } и так далее. Если вы пишете агента на TypeScript или Python, используйте официальные клиенты @modelcontextprotocol/sdk — они сами разбирают конверты и согласуют capabilities.

Доступные инструменты (19)

Каждый инструмент ниже проверяет указанное право перед выполнением. Вызов, прошедший аутентификацию, но без нужного права, возвращает JSON-RPC-результат с isError: true и явным кодом в стиле FORBIDDEN; всё соединение при этом не закрывается.

Итого 19 инструментов — 6 Actions, 7 Workflows, 3 Connectors, 3 Builds.

Сервер также предоставляет capabilities MCP resources и prompts. Основная поверхность — это обнаружение инструментов; resources и prompts используются встроенным onboarding-текстом сервера triggo-runtime и для большинства агентных интеграций их можно безопасно игнорировать.

Диагностика

• 401 Unauthorized — Bearer-токен отсутствует, некорректен, истёк или отозван. Пересоздайте ключ в Agent Setup и выкатите снова.
• 403 Forbidden на конкретном инструменте — ключ валиден, но не несёт право, которое требует инструмент. Добавьте право к ключу (или выпустите новый ключ) и повторите. Имя права указано в таблице выше.
• После подключения не видно инструментов — ключ прошёл валидацию, но список прав у него пуст, и предварительная проверка каждого инструмента не проходит. Отредактируйте ключ и добавьте хотя бы actions:read, actions:run, runs:read, connectors:read.
• Connection refused / ошибка DNS — неверный хост или инстанс Triggo недоступен из сети клиента. Попробуйте curl -sS https://api.triggo.dev/healthz. Если не отвечает — сервер лежит; если отвечает — URL в конфиге клиента неверный.
• Workflow-инструменты не видны в tools/list — ключ прошёл валидацию, но не несёт права workflows:read / workflows:write, поэтому предварительная проверка их отфильтровывает. Отредактируйте ключ в Agent Setup и выдайте эти права (оба канонические и назначаемые сегодня) либо выпустите новый ключ с ними.

Связанное

• Обзор интеграции с агентами — как выбирать между REST и MCP.
• API-ключи — права, ротация, отзыв.
• Публикация workflow как действий — как превратить workflow в то, что видит list_actions.