MCP для AI-агентов

MCP даёт внешнему AI-агенту рабочий доступ к платформе: читать аналитику, помогать с опросами и выполнять действия от имени пользователя. Подключение идёт через Streamable HTTP endpoint:

https://<домен-платформы>/mcp

При первом обращении агент открывает OAuth-вход в браузере. Вы видите, какой клиент просит доступ и какие scopes он запрашивает. После подтверждения токен хранит сам MCP-клиент; вручную копировать секрет не нужно.

Один endpoint работает для всех ваших организаций. Активная организация берётся из авторизованной сессии; если агент поддерживает переключение организации, он сможет выбрать другую доступную организацию.

Claude

Для Claude Code добавьте HTTP MCP-сервер:

claude mcp add --transport http tealband https://<домен-платформы>/mcp

Откройте Claude Code и выполните /mcp, затем пройдите OAuth в браузере. Если нужно запустить вход из терминала, используйте:

claude mcp login tealband

Codex

Добавьте Streamable HTTP сервер:

codex mcp add tealband --url https://<домен-платформы>/mcp

Затем выполните OAuth-вход:

codex mcp login tealband

В Codex CLI состояние подключения видно через /mcp.

OpenCode

Добавьте сервер в opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "tealband": {
      "type": "remote",
      "url": "https://<домен-платформы>/mcp",
      "enabled": true
    }
  }
}

При первом использовании OpenCode предложит авторизоваться. Вручную запустить OAuth можно так:

opencode mcp auth tealband

OpenClaw

Сохраните MCP-сервер как Streamable HTTP и включите OAuth:

openclaw mcp add tealband \
  --url https://<домен-платформы>/mcp \
  --transport streamable-http \
  --auth oauth

Запустите вход и проверьте подключение:

openclaw mcp login tealband
openclaw mcp doctor tealband --probe

Если login вернул код подтверждения, завершите вход командой:

openclaw mcp login tealband --code <code>

Если редактируете конфиг вручную, форма такая:

{
  "mcp": {
    "servers": {
      "tealband": {
        "url": "https://<домен-платформы>/mcp",
        "transport": "streamable-http",
        "auth": "oauth"
      }
    }
  }
}

Hermes

Добавьте сервер в ~/.hermes/config.yaml:

mcp_servers:
  tealband:
    url: "https://<домен-платформы>/mcp"
    auth: oauth

Запустите Hermes. При первом подключении он откроет OAuth в браузере и сохранит токены для следующих сессий. После изменения конфига в уже открытой сессии выполните:

/reload-mcp

Доступ

Агент получает только подтверждённые scopes:

• analytics:read — читать опросы, результаты, аналитику и точки роста;
• surveys:write — создавать, редактировать и публиковать опросы;
• org:manage — управлять организациями, настройками и участниками.

Scopes не заменяют роль пользователя. Если ваша роль не позволяет выполнить действие в организации, агент тоже не сможет его выполнить.

Приватность

MCP не открывает ответы участников в обход правил платформы. Ответы в чистом виде не видит никто; наружу выходят только обезличенные данные и агрегаты при достаточном числе ответов (не меньше 5). Если данных мало, агент получит ограниченный результат.

Для обычных скриптов и серверных интеграций используйте API-токены. MCP нужен именно AI-агентам, которым важны tools, resources, prompts, OAuth и отдельные scopes.