LLM Комплет

FastComments LLM Комплет помаже AI асистентима за кодирање као што су Claude, ChatGPT и Cursor да разумеју и интегришу FastComments тако што им обезбеђује приступ нашој целокупној документацији преко једноставног API-ја за претрагу.

Додавањем исечка у AGENT.md или CLAUDE.md датотеку вашег пројекта, омогућавате AI асистентима да брзо претражују и преузимају релевантну FastComments документацију, чинећи имплементацију бржом и прецизнијом.

Набавите LLM Комплет

Додајте овај исечак у конфигурационе датотеке АИ асистента вашег пројекта (као што су AGENT.md или CLAUDE.md) који учи АИ асистенте за кодирање како да претражују и приступају документацији FastComments.

FastComments LLM Kit

Copy

## FastComments Integration
FastComments is an embeddable live commenting platform with libraries for many frontend and backend integrations, along with client and server-side SDKs and APIs.
When working with FastComments, you can search the FastComments documentation by calling this API:
https://docs-search.fastcomments.com/search?query=<search_query>&full=true&tenantId=demo
Replace `<search_query>` with your search terms (URL encoded). The API returns relevant documentation snippets to help with implementation.

На овај начин ваш АИ асистент може лако добити ажуриране информације и пружити тачније имплементације у краћем времену.

Пример коришћења

Када користите АИ асистента као што је Claude Code или Cursor, можете постављати питања попут:

"Како инсталирати FastComments на React?"
"Покажи ми како да конфигуришем SSO са FastComments"
"Које су опције аутентификације FastComments API-ја?"

АИ асистент ће аутоматски претражити документацију користећи наведену API крајњу тачку и дати вам тачне, ажуриране одговоре засноване на званичној документацији.

MCP Сервер

FastComments покреће хостовани Model Context Protocol (MCP) сервер тако да AI асистенти и агентски клијенти могу директно позивати FastComments API. Сваки алат који MCP сервер излаже аутоматски је генерисан из јавне OpenAPI спецификације, тако да све што REST API може, MCP клијент такође може.

Крајња тачка је без стања и заснована на streamable-HTTP. Не постоји сесија која се одржава и нема серверског стања по клијенту.

Endpoint

MCP крајња тачка

Copy

https://fastcomments.com/mcp

Повежи се помоћу OAuth

Било који MCP клијент који подржава удаљене сервере са OAuth (Claude, ChatGPT, Claude Code, Cursor и други) може се повезати на горе наведену крајњу тачку без подешавања на страни FastComments. Клијент се региструје преко Dynamic Client Registration или се идентификује помоћу Client ID Metadata Document, отвара прегледач како бисте се пријавили у FastComments и одобрили приступ, и добија токен везан за налог у који сте пријављени.

Документи за откривање се налазе на стандардним локацијама:

Откривање

Copy

https://fastcomments.com/.well-known/oauth-protected-resource/mcp
https://fastcomments.com/.well-known/oauth-authorization-server

Ваш корисник треба да има дозволу API Admin на налогу да би одобрио везу. Ако управљате више налога, пре одобравања пређите на исправан у контролној табли.

Клијент може затражити read опсег, write опсег, или оба. Клијент који не затражи ништа добија оба. Алати који мењају податке се не нуде токену који има само read дозволу.

Контролна табла има помоћник за подешавање са готовим исечцима за копирање. Отворите Integrate -> MCP Server, или га посетите директно:

Страница за подешавање

Copy

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

Claude Code

Региструјте FastComments сервер једном командом, а затим покрените /mcp унутар сесије да се пријавите и видите доступне алате:

Claude Code подешавање

Copy

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

Cursor и други клијенти конфигурационог фајла

Додајте овај блок у конфигурацију MCP сервера вашег клијента (mcp.json за Cursor). Клијент отвара прегледач за пријаву приликом првог коришћења.

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

Copy

{
  "mcpServers": {
    "fastcomments": {
      "type": "http",
      "url": "https://fastcomments.com/mcp"
    }
  }
}

Одузимање приступа

Свака одобрена веза је наведена под Integrate -> Connected Apps у контролној табли. Одузимање једне везе поништава сваки токен који та апликација има. Апликације се региструју када се повежу, а FastComments их не прегледа, па одузмите све што не препознајете.

Коришћење токена са REST API-јем

Приступни токен који MCP клијент добије је уобичајена FastComments API акредитив. Ради на свакој /api/v1 крајњој тачки као bearer токен, тако да апликација која се повезала преко MCP-а такође може директно позивати REST API:

Bearer токен

Copy

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

Тенант је подразумеван токеном. tenantId се и даље може проследити, али мора да се поклапа. GET захтеви захтевају read опсег, а све остало захтева write опсег.

Повежи се помоћу API кључа

Клијенти који не могу да заврше пријаву у прегледачу, као што су безглави сервери, могу се аутентификоваћим помоћу API кључа. Проследите tenantId и API_KEY као параметре упита, или као x-tenant-id и x-api-key HTTP заглавља ако ваш клијент подржава прилагођена заглавља:

API кључ крајња тачка

Copy

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

Страница за подешавање генерише овај URL за сваки ваш API кључ.

Безбедност

URL крајње тачке који садржи API кључ је тајна: немојте га копирати у јавне разговоре, снимке екрана или комите. Ако кључ буде изложен, ротирајте га на страници API кључева у вашој контролној табли. OAuth токени не представљају такву ризику јер су везани за једну апликацију и могу се одузети из Connected Apps.

Нека агент подеси ваш налог

Агент за кодирање као што су Claude Code, Cursor или асистент заснован на MCP може да подеси FastComments уместо вас, без попуњавања регистрационог обрасца. Ово је корисно када замолите агента да „додаје коментаре на мом сајту“, а још немате налог.

Како то функционише

Агент креира нови налог и добија API кључ и линк за преузимање налога. API кључ одмах ради, тако да агент може да конфигурише налог и инсталира виџет на ваш сајт.
Агент вам даје линк за преузимање налога. Отворите га у прегледачу, пријавите се или направите налог, и потврдите преузимање. Налог је тада ваш: управљате њиме, његовим наплатом и његовим API кључевима са контролне табле. Страница наводи API кључ који агент држи, тако да га можете опозвати ако више не желите да агент, или онај ко га води, има приступ.
Ако нико не отвори линк за преузимање у року од 72 сата, налог и његов кључ се бришу. Замолите агента да направи нови.

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

Ако већ имате налог

Свака пријава поседује један налог. Ако отворите линк за преузимање док сте пријављени на постојећи налог, страница вам омогућава да изаберете:

Прикачи на мој налог чини нови налог управљаним станаром налога на који сте пријављени. Ово захтева плаћени план са white labeling, а потрошња новог станара се наплаћује вашем налогу.
Одјави се и преузми са другим налогом вас одјављује и враћа на страницу за преузимање како бисте га преузели са другим налогом.

За ауторе агената

Упутства за агенте на fastcomments.com/agents.md описују позив за креирање налога, поља у одговору и како да предате линк за преузимање особи за коју радите. Позив не захтева API кључ и ограничен је по IP адреси.

LLM Интеграција

MCP Сервер

Подешавање налога агента

LLM Комплет