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 工具包通过一个简单的搜索 API，向像 Claude、ChatGPT 和 Cursor 这样的 AI 编程助手提供对我们完整文档的访问，帮助它们理解并与 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 运行一个托管的模型上下文协议（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 侧进行任何设置。客户端通过动态客户端注册（Dynamic Client Registration）自行注册，或通过客户端 ID 元数据文档（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，或直接访问：

设置页面
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 作为查询参数传递，或者如果你的客户端支持自定义 HTTP 头，则作为 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 页面上轮换该密钥。OAuth 令牌没有此类风险，因为它们绑定到单个应用，并且可以从 Connected Apps 中撤销。

让代理为您设置账户 Internal Link

像 Claude Code、Cursor 或基于 MCP 的助手这样的编码代理可以为您设置 FastComments，而无需您填写注册表单。当您让代理“为我的网站添加评论”而您还没有账户时，这非常有用。

工作原理

  1. 代理创建一个新账户，并获得一个 API 密钥和一个认领链接。API 密钥立即可用，因此代理可以配置账户并在您的网站上安装评论组件。
  2. 代理将认领链接提供给您。在浏览器中打开该链接，登录或创建一个登录账号，并确认认领。此后该账户就归您所有：您可以在仪表板中管理它、它的账单以及它的 API 密钥。该页面列出了代理持有的 API 密钥，如果您不再希望该代理（或运行它的人）拥有访问权限，您可以撤销它。
  3. 如果 72 小时内没有人打开认领链接，该账户及其密钥将被删除。请让代理重新创建一个。

在认领之前，该账户与普通免费试用具有相同的限制。

如果您已有账户

每个登录账号拥有一个账户。如果您在登录现有账户的情况下打开认领链接，页面会让您选择：

  • 附加到我的账户会将新账户设为您当前登录账户的托管租户。这需要一个带白标功能的付费套餐，并且新租户的使用量会计入您账户的账单。
  • 退出登录并用其他登录账号认领会将您退出登录，并带您回到认领页面，以便您使用其他登录账号进行认领。

面向代理作者

fastcomments.com/agents.md 上的代理说明描述了账户创建调用、响应中的字段，以及如何将认领链接交给您的委托人。该调用不需要 API 密钥，并且按 IP 地址进行速率限制。

为本指南贡献