Набір LLM

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

Кінцева точка є безстановою та базується на streamable‑HTTP. Не існує сесії, яку треба підтримувати, і немає серверного стану для кожного клієнта.

Endpoint

Кінцева точка MCP

Copy

1

2https://fastcomments.com/mcp

3

Connect with OAuth

Будь-який клієнт MCP, який підтримує віддалені сервери з OAuth (Claude, ChatGPT, Claude Code, Cursor та інші), може підключитися до вищезазначеної кінцевої точки без налаштувань зі сторони FastComments. Клієнт реєструє себе через Dynamic Client Registration або ідентифікує себе за допомогою документа Client ID Metadata, відкриває браузер, щоб ви могли ввійти в 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 and other config-file clients

Додайте цей блок до конфігурації 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

Revoking access

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

Using the token with the REST API

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

Токен Bearer

Copy

1

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

3

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

Connect with an API key

Клієнти, які не можуть виконати вхід у браузері, наприклад безголові сервери, можуть автентифікуватися за допомогою 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 ключа.

Security

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

A coding agent such as Claude Code, Cursor, or an MCP-based assistant can set up FastComments for you without you filling in the signup form. This is useful when you ask an agent to "add comments to my site" and you do not have an account yet.

Як це працює

1. The agent creates a new account and receives an API key and a claim link. The API key works right away, so the agent can configure the account and install the widget on your site.
2. The agent gives you the claim link. Open it in your browser, log in or create a login, and confirm the claim. The account is then yours: you manage it, its billing, and its API keys from the dashboard. The page lists the API key the agent holds so you can revoke it if you no longer want the agent, or whoever runs it, to have access.
3. If nobody opens the claim link within 72 hours, the account and its key are deleted. Ask the agent to create a new one.

Until it is claimed, the account has the same limits as a normal free trial.

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

Each login owns one account. If you open a claim link while logged in to an existing account, the page lets you choose:

• Attach to my account makes the new account a managed tenant of the one you are logged in to. This needs a paid plan with white labeling, and the new tenant's usage is billed to your account.
• Sign out and claim with another login signs you out and brings you back to the claim page so you can claim it with a different login.

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

The agent instructions at fastcomments.com/agents.md describe the account creation call, the fields in the response, and how to hand the claim link to the person you are working for. The call needs no API key and is rate limited per IP address.