FastComments.com

Menu Icon

언어 🇰🇷 한국어
🇺🇸 English 🇧🇬 Български 🇨🇳 简体中文 🇹🇼 繁體中文 🇭🇷 Hrvatski 🇩🇰 Dansk 🇳🇱 Nederlands 🇫🇷 Français (France) 🇩🇪 Deutsch 🇬🇷 Ελληνικά 🇮🇱 עברית 🇮🇹 Italiano 🇯🇵 日本語 🇰🇷 한국어 🇵🇱 Polski 🇧🇷 Português (Brasil) 🇷🇺 Русский 🇷🇸 Srpski (Latinica) 🇷🇸 Српски 🇸🇮 Slovenščina 🇪🇸 Español 🇺🇦 Українська 🇹🇷 Türkçe

LLM 통합

LLM 키트 받기

MCP 서버

MCP 서버

에이전트 계정 설정

에이전트가 계정을 설정하도록 하세요

LLM 키트

LLM 키트

FastComments LLM 키트는 Claude, ChatGPT, Cursor와 같은 AI 코딩 어시스턴트가 간단한 검색 API를 통해 당사의 전체 문서에 접근할 수 있게 하여 FastComments를 이해하고 통합하도록 돕습니다.

프로젝트의 AGENT.md 또는 CLAUDE.md 파일에 스니펫을 추가하면 AI 어시스턴트가 관련 FastComments 문서를 빠르게 검색하고 검색 결과를 가져올 수 있어 구현이 더 빠르고 정확해집니다.

LLM 키트 받기 Internal Link

이 스니펫을 프로젝트의 AI 어시스턴트 구성 파일(AGENT.md 또는 CLAUDE.md 등)에 추가하세요. AI 코딩 어시스턴트가 FastComments 문서를 검색하고 액세스하는 방법을 알려줍니다.

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

이렇게 하면 AI 어시스턴트가 최신 정보를 쉽게 얻고 더 짧은 시간 내에 더 정확한 구현을 제공할 수 있습니다.

사용 예시

Claude Code 또는 Cursor와 같은 AI 어시스턴트를 사용할 때 다음과 같은 질문을 할 수 있습니다:

  • "React에 FastComments를 어떻게 설치하나요?"
  • "FastComments로 SSO를 구성하는 방법을 보여주세요"
  • "FastComments API 인증 옵션은 무엇인가요?"

AI 어시스턴트는 제공된 API 엔드포인트를 사용하여 자동으로 문서를 검색하고 공식 문서를 기반으로 정확하고 최신의 답변을 제공합니다.

MCP 서버 Internal Link

FastComments는 호스팅된 Model Context Protocol (MCP) 서버를 실행하여 AI 어시스턴트와 에이전트 클라이언트가 FastComments API를 직접 호출할 수 있도록 합니다. MCP 서버가 제공하는 모든 도구는 공개 OpenAPI 사양에서 자동 생성되므로 REST API가 할 수 있는 모든 작업을 MCP 클라이언트도 수행할 수 있습니다.

엔드포인트는 무상태이며 스트리밍 가능한 HTTP 기반입니다. 유지해야 할 세션이 없으며 클라이언트당 서버 측 상태도 없습니다.

Endpoint

MCP 엔드포인트
Copy Copy
1
2https://fastcomments.com/mcp
3

Connect with OAuth

OAuth(Claude, ChatGPT, Claude Code, Cursor 등)를 지원하는 모든 MCP 클라이언트는 FastComments 측에서 별도의 설정 없이 위 엔드포인트에 연결할 수 있습니다. 클라이언트는 동적 클라이언트 등록(Dynamic Client Registration)이나 클라이언트 ID 메타데이터 문서를 통해 자신을 등록하고, 브라우저를 열어 FastComments에 로그인하고 접근을 승인한 뒤, 로그인한 계정에 연결된 토큰을 받습니다.

디스커버리 문서는 표준 위치에 있습니다:

디스커버리
Copy Copy
1
2https://fastcomments.com/.well-known/oauth-protected-resource/mcp
3https://fastcomments.com/.well-known/oauth-authorization-server
4

연결을 승인하려면 해당 계정에 대한 API 관리자 권한이 필요합니다. 여러 계정을 관리하는 경우, 승인하기 전에 대시보드에서 올바른 계정으로 전환하십시오.

클라이언트는 read 범위, write 범위 또는 둘 다를 요청할 수 있습니다. 아무 것도 요청하지 않는 클라이언트는 두 범위를 모두 받습니다. 데이터를 변경하는 도구는 읽기 전용 토큰에는 제공되지 않습니다.

대시보드에는 바로 복사해 붙일 수 있는 스니펫이 포함된 설정 도우미가 있습니다. Integrate -> MCP Server를 열거나 직접 방문하십시오:

설정 페이지
Copy Copy
1
2https://fastcomments.com/auth/my-account/mcp-setup
3

Claude Code

한 명령으로 FastComments 서버를 등록한 뒤, 세션 내에서 /mcp를 실행하여 로그인하고 사용 가능한 도구를 나열합니다:

Claude Code 설정
Copy Copy
1
2claude mcp add --transport http fastcomments https://fastcomments.com/mcp
3

Cursor and other config-file clients

이 블록을 클라이언트의 MCP 서버 구성(Cursor의 경우 mcp.json)에 추가하십시오. 클라이언트는 처음 사용할 때 브라우저를 열어 로그인합니다.

MCP 클라이언트 구성
Copy 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 Copy
1
2curl -H "Authorization: Bearer fcat_..." https://fastcomments.com/api/v1/comments
3

테넌트는 토큰에 의해 암시됩니다. tenantId를 전달할 수도 있지만 토큰과 일치해야 합니다. GET 요청은 read 범위가 필요하고, 그 외의 모든 요청은 write 범위가 필요합니다.

Connect with an API key

브라우저 로그인 절차를 수행할 수 없는 클라이언트(예: 헤드리스 서버)는 대신 API 키로 인증할 수 있습니다. tenantId와 API_KEY를 쿼리 매개변수로 전달하거나, 클라이언트가 사용자 정의 헤더를 지원하는 경우 x-tenant-id와 x-api-key HTTP 헤더로 전달하십시오:

API 키 엔드포인트
Copy Copy
1
2https://fastcomments.com/mcp?tenantId=YOUR_TENANT_ID&API_KEY=YOUR_API_KEY
3

설정 페이지는 각 API 키에 대해 이 URL을 생성합니다.

Security

API 키가 포함된 엔드포인트 URL은 비밀 정보이므로 공개 채팅, 스크린샷 또는 커밋에 붙여넣지 마십시오. 키가 노출된 경우 대시보드의 API Keys 페이지에서 키를 교체하십시오. OAuth 토큰은 하나의 애플리케이션에만 연결되어 있으며 Connected Apps에서 해제할 수 있기 때문에 이러한 위험이 없습니다.

에이전트가 계정을 설정하도록 하세요 Internal Link

A coding agent such as Claude Code, Cursor, or an MCP-based assistant can set up FastComments for you without you filling in the signup form. This is useful when you ask an agent to "add comments to my site" and you do not have an account yet.

작동 방식

  1. 에이전트가 새 계정을 생성하고 API 키와 클레임 링크를 받습니다. API 키는 즉시 사용할 수 있어 에이전트가 계정을 구성하고 위젯을 사이트에 설치할 수 있습니다.
  2. 에이전트가 클레임 링크를 제공합니다. 브라우저에서 해당 링크를 열고 로그인하거나 계정을 생성한 뒤 클레임을 확인합니다. 그러면 계정은 여러분의 것이 됩니다: 대시보드에서 계정, 청구 및 API 키를 관리할 수 있습니다. 페이지에는 에이전트가 보유하고 있는 API 키가 표시되므로, 더 이상 에이전트나 운영자가 접근하지 않도록 원한다면 해당 키를 취소할 수 있습니다.
  3. 72시간 이내에 아무도 클레임 링크를 열지 않으면, 계정과 해당 키가 삭제됩니다. 에이전트에게 새 계정을 만들도록 요청하세요.

클레임이 완료될 때까지, 해당 계정은 일반 무료 체험과 동일한 제한을 가집니다.

이미 계정이 있는 경우

각 로그인은 하나의 계정을 소유합니다. 기존 계정에 로그인한 상태에서 클레임 링크를 열면, 페이지에서 다음 중 하나를 선택할 수 있습니다:

  • 내 계정에 연결은 새 계정을 현재 로그인한 계정의 관리형 테넌트로 만듭니다. 이를 위해서는 화이트 라벨링이 포함된 유료 플랜이 필요하며, 새 테넌트의 사용량은 귀하의 계정에 청구됩니다.
  • 로그아웃하고 다른 로그인으로 클레임은 로그아웃을 수행하고 클레임 페이지로 돌아가 다른 로그인으로 클레임할 수 있게 합니다.

에이전트 작성자를 위한 안내

에이전트 안내서는 fastcomments.com/agents.md에서 확인할 수 있으며, 계정 생성 호출, 응답에 포함된 필드, 그리고 작업 중인 사람에게 클레임 링크를 전달하는 방법을 설명합니다. 이 호출은 API 키가 필요 없으며 IP 주소당 속도 제한이 적용됩니다.

이 가이드에 기여하기