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.