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 като query параметри, или като 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 часа, акаунтът и неговият ключ се изтриват. Помолете агента да създаде нов.

Докато не бъде заявен, акаунтът има същите ограничения като обикновен безплатен пробен период.

Ако вече имате акаунт

Всяко влизане притежава един акаунт. Ако отворите връзка за заявяване, докато сте влезли в съществуващ акаунт, страницата ви позволява да изберете:

• Attach to my account прави новия акаунт управляван наемател на този, в който сте влезли. Това изисква платен план с бяло маркиране, а използването на новия наемател се таксува към вашия акаунт.
• Sign out and claim with another login ви изписва и ви връща обратно към страницата за заявяване, за да можете да я заявите с различен вход.

За автори на агенти

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