LLM комплект

FastComments управлява хостван сървър за Model Context Protocol (MCP), така че AI асистентите и агентните клиенти да могат директно да извикват FastComments API. Всеки инструмент, който сървърът 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 или се идентифицира с документ за метаданни на клиентския идентификатор, отваря браузър, за да влезете във 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 клиент получава, е обикновено FastComments API удостоверение. Той работи на всяка крайна точка /api/v1 като токен за носител, така че приложение, свързано чрез MCP, може също директно да извика REST API:

Токен за носител

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.

Кодиращ агент като 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 адрес.