Набор LLM

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

The endpoint is stateless and streamable-HTTP based. There is no session to keep alive and no server-side state per client.

Endpoint

Конечная точка MCP

Copy

1

2https://fastcomments.com/mcp

3

Connect with OAuth

Any MCP client that supports remote servers with OAuth (Claude, ChatGPT, Claude Code, Cursor, and others) can connect to the endpoint above with no setup on the FastComments side. The client registers itself through Dynamic Client Registration or identifies itself with a Client ID Metadata Document, opens a browser so you can sign in to FastComments and approve access, and receives a token bound to the account you were signed in to.

Your user needs the API Admin permission on the account to approve a connection. If you manage several accounts, switch to the right one in the dashboard before approving.

A client can request the read scope, the write scope, or both. A client that requests nothing gets both. Tools that change data are not offered to a read-only token.

The dashboard has a setup helper with ready-to-paste snippets. Open Integrate -> MCP Server, or visit it directly:

Страница настройки

Copy

1

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

3

Claude Code

Register the FastComments server with one command, then run /mcp inside a session to sign in and list the available tools:

Настройка Claude Code

Copy

1

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

3

Cursor and other config-file clients

Add this block to your client's MCP servers config (mcp.json for Cursor). The client opens a browser to sign in on first use.

Конфигурация клиента MCP

Copy

1

2{

3 "mcpServers": {

4 "fastcomments": {

5 "type": "http",

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

7 }

8 }

9}

10

Revoking access

Every approved connection is listed under Integrate -> Connected Apps in the dashboard. Revoking one invalidates every token that application holds. Applications register themselves when they connect and FastComments does not review them, so revoke anything you do not recognize.

Using the token with the REST API

The access token an MCP client obtains is a regular FastComments API credential. It works on every /api/v1 endpoint as a bearer token, so an application that connected through MCP can also call the REST API directly:

Токен доступа

Copy

1

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

3

The tenant is implied by the token. A tenantId may still be passed but it must match. GET requests need the read scope and everything else needs the write scope.

Connect with an API key

Clients that cannot complete a browser sign-in, such as headless servers, can authenticate with an API key instead. Pass tenantId and API_KEY as query parameters, or as the x-tenant-id and x-api-key HTTP headers if your client supports custom headers:

Конечная точка API-ключа

Copy

1

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

3

The setup page generates this URL for each of your API keys.

Security

An endpoint URL that contains an API key is a secret: do not paste it into public chats, screenshots, or commits. If a key is exposed, rotate it on the API Keys page in your dashboard. OAuth tokens carry no such risk because they are bound to one application and can be revoked from Connected Apps.

Кодирующий агент, такой как Claude Code, Cursor или помощник на основе MCP, может настроить FastComments для вас без заполнения формы регистрации. Это полезно, когда вы просите агента "добавить комментарии на мой сайт", а у вас еще нет аккаунта.

Как это работает

1. Агент создает новый аккаунт и получает API‑ключ и ссылку для подтверждения. API‑ключ работает сразу, поэтому агент может настроить аккаунт и установить виджет на ваш сайт.
2. Агент дает вам ссылку для подтверждения. Откройте её в браузере, войдите в систему или создайте учётную запись, и подтвердите запрос. После этого аккаунт будет вашим: вы управляете им, его биллингом и API‑ключами через панель управления. На странице отображается API‑ключ, которым владеет агент, чтобы вы могли отозвать его, если больше не хотите, чтобы агент или кто‑то, кто его использует, имел доступ.
3. Если никто не откроет ссылку для подтверждения в течение 72 часов, аккаунт и его ключ будут удалены. Попросите агента создать новый.

Пока аккаунт не подтверждён, он имеет те же ограничения, что и обычный бесплатный пробный период.

Если у вас уже есть аккаунт

Каждый вход в систему владеет одним аккаунтом. Если вы откроете ссылку для подтверждения, будучи вошедшим в существующий аккаунт, страница предложит вам выбрать:

• Привязать к моему аккаунту делает новый аккаунт управляемым арендатором того, в который вы вошли. Это требует платного плана с белой маркировкой, и использование нового арендатора будет списано с вашего аккаунта.
• Выйти и подтвердить с другим входом выходит из системы и возвращает вас на страницу подтверждения, чтобы вы могли подтвердить её с другим входом.

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

Инструкции для агентов на странице fastcomments.com/agents.md описывают запрос создания аккаунта, поля в ответе и то, как передать ссылку для подтверждения человеку, для которого вы работаете. Запрос не требует API‑ключа и ограничен по частоте запросов для каждого IP‑адреса.