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 클라이언트도 수행할 수 있습니다.

엔드포인트는 상태 비저장(stateless)이며 streamable-HTTP 기반입니다. 유지해야 할 세션이 없고 클라이언트별 서버 측 상태도 없습니다.

엔드포인트

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

OAuth로 연결

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

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

디스커버리
Copy 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를 열거나 다음 URL로 직접 방문하세요:

설정 페이지
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 및 기타 설정 파일 기반 클라이언트

클라이언트의 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

접근 권한 해지

승인된 모든 연결은 대시보드의 Integrate -> Connected Apps에 나열됩니다. 연결을 해지하면 해당 애플리케이션이 보유한 모든 토큰이 무효화됩니다. 애플리케이션은 연결 시 자신을 등록하며 FastComments는 이를 검토하지 않으므로, 인식하지 못하는 애플리케이션은 해지하세요.

REST API에서 토큰 사용

MCP 클라이언트가 얻은 액세스 토큰은 일반적인 FastComments API 자격 증명입니다. 모든 /api/v1 엔드포인트에서 bearer 토큰으로 작동하므로, MCP를 통해 연결된 애플리케이션은 REST API를 직접 호출할 수도 있습니다:

Bearer 토큰
Copy Copy
1
2curl -H "Authorization: Bearer fcat_..." https://fastcomments.com/api/v1/comments
3

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

API 키로 연결

헤드리스 서버와 같이 브라우저 로그인을 완료할 수 없는 클라이언트는 대신 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을 생성해 줍니다.

보안

API 키가 포함된 엔드포인트 URL은 비밀 정보입니다. 공개 채팅, 스크린샷 또는 커밋에 붙여넣지 마세요. 키가 노출된 경우 대시보드의 API Keys 페이지에서 키를 교체(rotate)하세요. OAuth 토큰은 하나의 애플리케이션에 바인딩되고 Connected Apps에서 해지할 수 있으므로 이러한 위험이 없습니다.

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

Claude Code, Cursor 또는 MCP 기반 어시스턴트 같은 코딩 에이전트가 가입 양식을 직접 작성하지 않아도 FastComments를 설정해 줄 수 있습니다. 에이전트에게 "내 사이트에 댓글 추가해 줘"라고 요청했는데 아직 계정이 없는 경우에 유용합니다.

작동 방식

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

클레임되기 전까지 해당 계정은 일반 무료 체험판과 동일한 제한을 갖습니다.

이미 계정이 있는 경우

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

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

에이전트 개발자를 위해

fastcomments.com/agents.md의 에이전트 지침에는 계정 생성 호출, 응답의 필드, 그리고 작업 대상자에게 클레임 링크를 전달하는 방법이 설명되어 있습니다. 이 호출은 API 키가 필요 없으며 IP 주소별로 요청이 제한됩니다.

이 가이드에 기여하기