Набір LLM

FastComments запускає хостинговий сервер Model Context Protocol (MCP), щоб AI-асистенти та агентні клієнти могли викликати FastComments API безпосередньо. Кожен інструмент, який надає MCP-сервер, автоматично генерується з публічної специфікації OpenAPI, тож усе, що може робити REST API, може робити й MCP-клієнт.

Ендпоінт є stateless та базується на streamable-HTTP. Немає сесії, яку потрібно підтримувати, і жодного серверного стану на клієнта.

Ендпоінт

MCP Ендпоінт

Copy

1

2https://fastcomments.com/mcp

3

Підключення через OAuth

Будь-який MCP-клієнт, який підтримує віддалені сервери з OAuth (Claude, ChatGPT, Claude Code, Cursor та інші), може підключитися до наведеного вище ендпоінта без жодних налаштувань з боку FastComments. Клієнт реєструється через Dynamic Client Registration або ідентифікує себе за допомогою Client ID Metadata Document, відкриває браузер, щоб ви могли увійти до FastComments та схвалити доступ, і отримує токен, прив'язаний до облікового запису, у який ви увійшли.

Документи виявлення знаходяться за стандартними адресами:

Виявлення

Copy

1

2https://fastcomments.com/.well-known/oauth-protected-resource/mcp

3https://fastcomments.com/.well-known/oauth-authorization-server

4

Ваш користувач повинен мати дозвіл API Admin на обліковому записі, щоб схвалити підключення. Якщо ви керуєте кількома обліковими записами, переключіться на потрібний у панелі керування перед схваленням.

Клієнт може запросити область read, область write або обидві. Клієнт, який нічого не запитує, отримує обидві. Інструменти, що змінюють дані, не надаються токену з доступом лише для читання.

Панель керування має помічник налаштування з готовими фрагментами для вставки. Відкрийте Integrate -> MCP Server або відвідайте її безпосередньо:

Сторінка налаштування

Copy

1

2https://fastcomments.com/auth/my-account/mcp-setup

3

Claude Code

Зареєструйте сервер FastComments однією командою, а потім виконайте /mcp у межах сесії, щоб увійти та переглянути доступні інструменти:

Налаштування Claude Code

Copy

1

2claude mcp add --transport http fastcomments https://fastcomments.com/mcp

3

Cursor та інші клієнти з файлами конфігурації

Додайте цей блок до конфігурації MCP-серверів вашого клієнта (mcp.json для Cursor). Клієнт відкриє браузер для входу при першому використанні.

Конфігурація MCP-клієнта

Copy

1

2{

3 "mcpServers": {

4 "fastcomments": {

5 "type": "http",

6 "url": "https://fastcomments.com/mcp"

7 }

8 }

9}

10

Відкликання доступу

Кожне схвалене підключення перелічено в розділі Integrate -> Connected Apps у панелі керування. Відкликання одного з них анулює всі токени, які має цей застосунок. Застосунки реєструють себе під час підключення, і FastComments їх не перевіряє, тому відкликайте все, що вам не знайоме.

Використання токена з REST API

Токен доступу, який отримує MCP-клієнт, є звичайним обліковим записом FastComments API. Він працює на кожному ендпоінті /api/v1 як bearer-токен, тож застосунок, який підключився через MCP, також може викликати REST API безпосередньо:

Bearer-токен

Copy

1

2curl -H "Authorization: Bearer fcat_..." https://fastcomments.com/api/v1/comments

3

Орендар визначається токеном. tenantId все ще можна передати, але він має збігатися. Запити GET потребують області read, а все інше — області write.

Підключення за допомогою API-ключа

Клієнти, які не можуть завершити вхід через браузер, наприклад headless-сервери, можуть автентифікуватися за допомогою API-ключа. Передайте tenantId та API_KEY як параметри запиту або як HTTP-заголовки x-tenant-id та x-api-key, якщо ваш клієнт підтримує користувацькі заголовки:

Ендпоінт з API-ключем

Copy

1

2https://fastcomments.com/mcp?tenantId=YOUR_TENANT_ID&API_KEY=YOUR_API_KEY

3

Сторінка налаштування генерує цю URL-адресу для кожного з ваших API-ключів.

Безпека

URL-адреса ендпоінта, що містить API-ключ, є секретом: не вставляйте її в публічні чати, скріншоти чи коміти. Якщо ключ було розкрито, змініть його на сторінці API Keys у вашій панелі керування. OAuth-токени не несуть такого ризику, оскільки вони прив'язані до одного застосунку і можуть бути відкликані через Connected Apps.

Агент для програмування, такий як Claude Code, Cursor або асистент на основі MCP, може налаштувати FastComments за вас, без заповнення форми реєстрації. Це корисно, коли ви просите агента «додати коментарі до мого сайту», а у вас ще немає облікового запису.

Як це працює

1. Агент створює новий обліковий запис і отримує API-ключ та посилання для підтвердження права власності (claim link). API-ключ працює одразу, тож агент може налаштувати обліковий запис і встановити віджет на вашому сайті.
2. Агент передає вам посилання для підтвердження. Відкрийте його у браузері, увійдіть або створіть обліковий запис і підтвердьте право власності. Після цього обліковий запис належить вам: ви керуєте ним, його білінгом та API-ключами з панелі керування. На сторінці вказано API-ключ, який використовує агент, тож ви можете відкликати його, якщо більше не хочете, щоб агент або той, хто ним керує, мав доступ.
3. Якщо ніхто не відкриє посилання для підтвердження протягом 72 годин, обліковий запис і його ключ буде видалено. Попросіть агента створити новий.

До моменту підтвердження обліковий запис має ті самі обмеження, що й звичайний безкоштовний пробний період.

Якщо у вас уже є обліковий запис

Кожен логін володіє одним обліковим записом. Якщо ви відкриєте посилання для підтвердження, будучи залогіненим у наявний обліковий запис, сторінка дозволить вам вибрати:

• Приєднати до мого облікового запису — новий обліковий запис стає керованим орендарем (tenant) того, у який ви залогінені. Для цього потрібен платний план з white labeling, а використання нового орендаря оплачується з вашого облікового запису.
• Вийти та підтвердити з іншим логіном — ви виходите з системи і повертаєтесь на сторінку підтвердження, щоб підтвердити його з іншим логіном.

Для авторів агентів

Інструкції для агентів за адресою fastcomments.com/agents.md описують виклик створення облікового запису, поля у відповіді та те, як передати посилання для підтвердження особі, на яку ви працюєте. Виклик не потребує API-ключа і має обмеження частоти запитів на IP-адресу.