Набор LLM

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

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

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

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

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

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

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

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