LLMキット

FastComments はホストされた Model Context Protocol (MCP) サーバーを実行し、AI アシスタントやエージェントクライアントが FastComments API を直接呼び出すことができます。MCP サーバーが公開するすべてのツールは公開 OpenAPI 仕様から自動生成されるため、REST API ができることはすべて MCP クライアントでも実行できます。

エンドポイントはステートレスでストリーム可能な HTTP ベースです。セッションを維持する必要はなく、クライアントごとのサーバー側状態もありません。

Endpoint

MCP エンドポイント

Copy

1

2https://fastcomments.com/mcp

3

OAuth で接続

OAuth（Claude、ChatGPT、Claude Code、Cursor など）をサポートするリモートサーバー対応の MCP クライアントは、FastComments 側での設定なしに上記エンドポイントに接続できます。クライアントは動的クライアント登録を通じて自身を登録するか、クライアント ID メタデータドキュメントで識別し、ブラウザを開いて FastComments にサインインしアクセスを承認すると、サインインしたアカウントに紐付いたトークンを受け取ります。

ディスカバリードキュメントは標準の場所にあります：

ディスカバリー

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

1

2https://fastcomments.com/auth/my-account/mcp-setup

3

Claude Code

1 つのコマンドで FastComments サーバーを登録し、セッション内で /mcp を実行してサインインし、利用可能なツールを一覧表示します：

Claude Code 設定

Copy

1

2claude mcp add --transport http fastcomments https://fastcomments.com/mcp

3

Cursor とその他の設定ファイルクライアント

このブロックをクライアントの MCP サーバー設定（Cursor の場合は mcp.json）に追加します。クライアントは初回使用時にブラウザを開いてサインインします。

MCP クライアント設定

Copy

1

2{

3 "mcpServers": {

4 "fastcomments": {

5 "type": "http",

6 "url": "https://fastcomments.com/mcp"

7 }

8 }

9}

10

アクセスの取り消し

承認されたすべての接続はダッシュボードの Integrate -> Connected Apps に一覧表示されます。1 つを取り消すと、そのアプリケーションが保持するすべてのトークンが無効になります。アプリケーションは接続時に自ら登録され、FastComments はそれらを審査しないため、認識できないものはすべて取り消してください。

REST API でトークンを使用する

MCP クライアントが取得するアクセストークンは通常の FastComments API 資格情報です。/api/v1 のすべてのエンドポイントでベアラートークンとして機能するため、MCP 経由で接続したアプリケーションは REST API を直接呼び出すこともできます：

ベアラートークン

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

1

2https://fastcomments.com/mcp?tenantId=YOUR_TENANT_ID&API_KEY=YOUR_API_KEY

3

セットアップページは各 API キーごとにこの URL を生成します。

セキュリティ

API キーを含むエンドポイント URL は機密情報です：公開チャットやスクリーンショット、コミットに貼り付けないでください。キーが漏洩した場合は、ダッシュボードの API キーページでローテーションしてください。OAuth トークンは 1 つのアプリケーションに紐付いており、Connected Apps から取り消すことができるため、このようなリスクはありません。

Claude Code、Cursor、またはMCPベースのアシスタントなどのコーディングエージェントは、サインアップフォームに入力することなくFastCommentsを設定できます。これは、エージェントに「サイトにコメントを追加してほしい」と依頼し、まだアカウントを持っていない場合に便利です。

仕組み

1. エージェントは新しいアカウントを作成し、APIキーとクレームリンクを受け取ります。APIキーはすぐに使用できるため、エージェントはアカウントを設定し、ウィジェットをサイトにインストールできます。
2. エージェントはクレームリンクをあなたに渡します。そのリンクをブラウザで開き、ログインするか新しくアカウントを作成し、クレームを確認してください。これでアカウントはあなたのものになります。ダッシュボードからアカウント、請求、APIキーを管理できます。ページにはエージェントが保持しているAPIキーが表示されるので、エージェントやその実行者のアクセスを不要とする場合はキーを取り消すことができます。
3. クレームリンクが72時間以内に誰にも開かれなかった場合、アカウントとそのキーは削除されます。エージェントに新しいアカウントの作成を依頼してください。

クレームが行われるまで、アカウントは通常の無料トライアルと同じ制限が適用されます。

既にアカウントをお持ちの場合

各ログインは1つのアカウントに紐づきます。既存のアカウントにログインした状態でクレームリンクを開くと、ページで以下の選択肢が表示されます：

• Attach to my account は、新しいアカウントを現在ログイン中のアカウントの管理テナントにします。これにはホワイトラベリング付きの有料プランが必要で、新しいテナントの使用量はあなたのアカウントに請求されます。
• Sign out and claim with another login は、ログアウトさせてクレームページに戻り、別のログインでクレームできるようにします。

エージェント作成者向け

エージェント向けの手順は fastcomments.com/agents.md に記載されており、アカウント作成の呼び出し方法、レスポンスのフィールド、クレームリンクを依頼先に渡す方法が説明されています。この呼び出しはAPIキーを必要とせず、IPアドレスごとにレート制限がかかります。