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 Kit

The FastComments LLM Kit 幫助像 Claude、ChatGPT 和 Cursor 這類 AI 程式助理理解並整合 FastComments，透過一個簡單的搜尋 API 提供它們存取我們完整文件的能力。

將一段程式碼片段加入專案的 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 運行一個託管的模型上下文協議 (MCP) 伺服器，使 AI 助手和代理客戶端能直接呼叫 FastComments API。MCP 伺服器所公開的每個工具皆由公共 OpenAPI 規範自動生成，因此 REST API 能做到的事，MCP 客戶端也能做到。

此端點是無狀態且基於可串流的 HTTP。沒有需要保持的會話，也沒有每個客戶端的伺服器端狀態。

端點

MCP 端點
Copy Copy
1
2https://fastcomments.com/mcp
3

使用 OAuth 連接

任何支援 OAuth 的遠端伺服器的 MCP 客戶端（如 Claude、ChatGPT、Claude Code、Cursor 等）都可以在 FastComments 端不需任何設定即可連接上述端點。客戶端透過動態客戶端註冊或使用客戶端 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 與其他設定檔客戶端

將此區塊加入客戶端的 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 憑證。它可作為 Bearer 令牌在所有 /api/v1 端點使用，因此透過 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 金鑰頁面重新產生。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. The agent creates a new account and receives an API key and a claim link. The API key works right away, so the agent can configure the account and install the widget on your site.
  2. The agent gives you the claim link. Open it in your browser, log in or create a login, and confirm the claim. The account is then yours: you manage it, its billing, and its API keys from the dashboard. The page lists the API key the agent holds so you can revoke it if you no longer want the agent, or whoever runs it, to have access.
  3. If nobody opens the claim link within 72 hours, the account and its key are deleted. Ask the agent to create a new one.

Until it is claimed, the account has the same limits as a normal free trial.

如果您已經有帳戶

Each login owns one account. If you open a claim link while logged in to an existing account, the page lets you choose:

  • Attach to my account makes the new account a managed tenant of the one you are logged in to. This needs a paid plan with white labeling, and the new tenant's usage is billed to your account.
  • Sign out and claim with another login signs you out and brings you back to the claim page so you can claim it with a different login.

給代理人作者

The agent instructions at fastcomments.com/agents.md describe the account creation call, the fields in the response, and how to hand the claim link to the person you are working for. The call needs no API key and is rate limited per IP address.

貢獻此指南