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

像 Claude Code、Cursor 或基於 MCP 的助理這類編碼代理可以在您不填寫註冊表單的情況下，為您設定 FastComments。當您要求代理「為我的網站新增留言」而您還沒有帳戶時，這非常實用。

運作方式

  1. 代理會建立一個新帳戶，並取得一組 API 金鑰與一個認領連結。API 金鑰可立即使用，因此代理可以設定該帳戶並在您的網站上安裝小工具。
  2. 代理會將認領連結提供給您。在瀏覽器中開啟該連結，登入或建立登入帳號，然後確認認領。該帳戶隨即歸您所有：您可以從儀表板管理它、它的帳單以及它的 API 金鑰。該頁面會列出代理持有的 API 金鑰，因此如果您不再希望代理（或其營運者）擁有存取權，可以撤銷該金鑰。
  3. 如果 72 小時內沒有人開啟認領連結，該帳戶及其金鑰將被刪除。請要求代理建立一個新的。

在被認領之前，該帳戶與一般免費試用具有相同的限制。

如果您已經有帳戶

每個登入帳號擁有一個帳戶。如果您在登入現有帳戶的狀態下開啟認領連結，頁面會讓您選擇：

  • 附加到我的帳戶 會將新帳戶變成您目前登入帳戶的受管理租戶。這需要具有白標功能的付費方案，且新租戶的使用量將計入您的帳戶帳單。
  • 登出並以其他登入帳號認領 會將您登出並帶回認領頁面，讓您可以使用不同的登入帳號進行認領。

給代理作者

fastcomments.com/agents.md 上的代理說明描述了帳戶建立呼叫、回應中的欄位，以及如何將認領連結交給您的委託人。該呼叫不需要 API 金鑰，並且每個 IP 位址都有速率限制。

貢獻此指南