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

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

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

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

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

Claude

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

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

Відкрийте Claude Code та виконайте /mcp, потім пройдіть OAuth у браузері. Якщо потрібно запустити вхід із терміналу, скористайтеся:

claude mcp login platform

Codex

Додайте Streamable HTTP сервер:

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

Потім виконайте OAuth-вхід:

codex mcp login platform

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

OpenCode

Додайте сервер у opencode.json:

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

При першому використанні OpenCode запропонує авторизуватися. Вручну запустити OAuth можна так:

opencode mcp auth platform

OpenClaw

Збережіть MCP-сервер як Streamable HTTP і увімкніть OAuth:

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

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

openclaw mcp login platform
openclaw mcp doctor platform --probe

Якщо login повернув код підтвердження, завершіть вхід командою:

openclaw mcp login platform --code <code>

Якщо редагуєте конфіг вручну, форма така:

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

Hermes

Додайте сервер у ~/.hermes/config.yaml:

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

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

/reload-mcp

Доступ

Агент отримує лише підтверджені scopes:

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

Scopes не замінюють роль користувача. Якщо ваша роль не дозволяє виконати дію в організації, агент також не зможе її виконати.

Ліміти запитів

Звернення до MCP захищені лімітами частоти:

• Робочий endpoint /mcp: 300 запитів на хвилину на токен або IP.
• OAuth-авторизація: 20 запитів на пару IP + client_id за 5 хвилин (120 запитів на IP).

У разі перевищення сервер повертає помилку rate_limited із зазначенням часу паузи (retryAfter).

Приватність

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

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