ドキュメント

AIエージェント(MCP)

MCPサーバーに接続する

Claude、Claude Code、ChatGPT、Cursor、VS Code、Codexを、MCP経由でAmICitedのワークスペースに接続します。URLは1つ、サインインはOAuth、代替としてAPIキーも使えます。

ChatGPTで開く Claudeで開く

AmICitedは、常時稼働するMCP(Model Context Protocol)サーバーを提供しています。AIクライアントを接続すると、可視性データの読み取りやレポートの実行ができ、書き込み権限があれば、プロンプトの追加、記事の生成、アノテーションの記録も、通常の会話の中で行えます。ダッシュボードのすべての機能はMCPツールとしても提供されているため、アプリでできることは、エージェントにもすべてできます。

始める前に#

  • MCPを含むプラン。 MCPは、7日間のトライアルと、Pro、Premium、Enterpriseで利用できます。Starterのワークスペースではサーバーのurlを確認できますが、プランをアップグレードするまで接続は拒否されます。プランと上限をご覧ください。
  • ワークスペースでの編集者以上の権限。権限のないメンバーには、MCP ページでワークスペースのオーナーまたは管理者に依頼するよう案内が表示されます。
  • プラスのクレジット残高。 MCP経由の読み取りは無料ですが、エンドポイントは応答する前にワークスペースにクレジットがあるかを確認します。クレジットをご覧ください。

サーバーURL#

URLは全員共通で1つです。

text
https://api.flowhunt.io/mcp/amicited

ワークスペースはURLに含まれません。認証情報から決まります。OAuthでは同意画面でワークスペースを選び、APIキーはすでに1つのワークスペースに属しています。アプリの MCP ページからもURLをコピーできます。ページには Copy URL ボタンと、以下と同じクライアントごとの手順が表示されます。トランスポートはストリーミング可能なHTTPです。

クライアントを接続する#

お使いのクライアントを選んでください。各タブは、推奨のOAuthサインインから始まり、代替のAPIキーで終わります。

Claude(WebとDesktop)

claude.aiで追加したコネクタは、Claude Desktopアプリでも利用できます。

  1. Claudeのコネクタ設定を開きます。
  2. + をクリックし、Add custom connector を選びます。
  3. https://api.flowhunt.io/mcp/amicited を貼り付け、Add をクリックします。
  4. 新しいコネクタで Connect をクリックし、開いたブラウザウィンドウでアクセスを承認します。同意画面でワークスペースを選びます。

チャットでは、ツールメニューを開き、AmICitedコネクタが有効になっていることを確認してください。

APIキーの代替(Claude Desktopの設定ファイル)。 macOSでは、~/Library/Application Support/Claude/claude_desktop_config.json の mcpServers の下に次を追加し、Claude Desktopを再起動します。

claude_desktop_config.json
{
  "mcpServers": {
    "amicited": {
      "type": "http",
      "url": "https://api.flowhunt.io/mcp/amicited",
      "headers": {
        "Authorization": "Bearer <your-workspace-api-key>"
      }
    }
  }
}

Claude Code

ターミナルからサーバーを1回登録します。

bash
claude mcp add --transport http amicited https://api.flowhunt.io/mcp/amicited

その後、Claude Code内で /mcp を実行し、Authenticate を選んで、開いたブラウザウィンドウでアクセスを承認します。

APIキーの代替。 ~/.claude.json のトップレベルの mcpServers キーの下にサーバーを追加し、Claude Codeを再起動します。

~/.claude.json
{
  "mcpServers": {
    "amicited": {
      "type": "http",
      "url": "https://api.flowhunt.io/mcp/amicited",
      "headers": {
        "Authorization": "Bearer <your-workspace-api-key>"
      }
    }
  }
}

ChatGPT

カスタムMCPコネクタにはDeveloper modeが必要で、有料のChatGPTプラン(Plus、Pro、Team、Enterprise)で利用できます。Business、Enterprise、Eduのワークスペースでは、管理者が有効にする必要がある場合があります。

  1. OpenAIのコネクタに関するドキュメントの手順に従って、Developer modeをオンにします。
  2. ChatGPTで Settings を開き、Apps & Connectors を選びます。
  3. カスタムコネクタを追加し、https://api.flowhunt.io/mcp/amicited を貼り付けます。
  4. 開いたブラウザウィンドウでアクセスを承認します。

APIキーの代替。 手順4で、代わりにAPIキー認証を選び、ワークスペースのAPIキーを貼り付けます。コネクタを保存し、新しいチャットで有効にします。

Cursor

アプリの MCP ページで Cursor を選び、Add to Cursor をクリックします。Cursorがサーバーをインストールし、サインインも実行します。

ボタンでCursorが開かない場合は、CursorのMCP設定から手動でサーバーを追加するか、~/.cursor/mcp.json(またはプロジェクトごとの .cursor/mcp.json)を編集します。

~/.cursor/mcp.json
{
  "mcpServers": {
    "amicited": {
      "url": "https://api.flowhunt.io/mcp/amicited"
    }
  }
}

初回の接続時に、Cursorがサインイン用のブラウザを開きます。ツールを使うには、チャットを Agent モードに設定してください。

APIキーの代替。 同じエントリにヘッダーを追加します。

json
"headers": { "Authorization": "Bearer <your-workspace-api-key>" }

VS Code

VS CodeはAgentモードの GitHub Copilotを通じてサーバーを利用するため、Copilotが有効になっている必要があります。

アプリの MCP ページで VS Code を選び、Add to VS Code をクリックします。VS Codeがサーバーをインストールし、サインインも実行します。

手動で追加するには、コマンドパレットを開いて MCP: Open User Configuration を実行し、servers の下にサーバーを追加します。

mcp.json
{
  "servers": {
    "amicited": {
      "type": "http",
      "url": "https://api.flowhunt.io/mcp/amicited"
    }
  }
}

APIキーの代替。 エントリに "headers": { "Authorization": "Bearer <your-workspace-api-key>" } を追加します。MCP: Add Server… を実行し、HTTP (HTTP or Server-Sent Events) を選んでURLを貼り付け、求められたら Authorization ヘッダーを追加することもできます。

Codex

Codexは、標準的なリモートMCPクライアントとして接続します。サーバーを追加してから、サインインします。

bash
codex mcp add amicited --url https://api.flowhunt.io/mcp/amicited
codex mcp login amicited

または、~/.codex/config.toml を直接編集します。

~/.codex/config.toml
[mcp_servers.amicited]
url = "https://api.flowhunt.io/mcp/amicited"
oauth_resource = "https://api.flowhunt.io/mcp/amicited"

APIキーの代替。 キーを環境変数に設定し、Codexにそれを指定します。

~/.codex/config.toml
[mcp_servers.amicited]
url = "https://api.flowhunt.io/mcp/amicited"
bearer_token_env_var = "AMICITED_API_KEY"

厳格な承認設定でCodexを実行していても、すべての読み取り専用ツールには read_tool を通じて引き続きアクセスできます。ツールセットとツールをご覧ください。

OAuthかAPIキーか#

OAuth 2.1(推奨)ワークスペースAPIキー(代替)
セットアップURLを貼り付け、ブラウザで承認URLと Authorization: Bearer ヘッダーを貼り付け
ワークスペース同意画面で選択キーによって固定
権限接続と読み取りには amicited:read、書き込みには amicited:write も必要ワークスペースへのフルアクセス
取り消しMCPページの Connected clients → Revokeキーを削除するか、失効させる

OAuthのほうが標準的な選択肢として優れています。設定ファイルに貼り付けるシークレットがなく、各クライアントが MCP ページの Connected clients に名前付きで表示され、他のクライアントに影響を与えずに1つだけ取り消せます。読み取り専用のOAuthトークンでもすべてを一覧表示して読み取れますが、作成、編集、削除を行うツールは、amicited:write スコープを示すメッセージとともに拒否されます。再試行しても解決しないため、書き込み権限付きで再接続してください。

APIキーはパスワードと同様に扱ってください

ワークスペースのAPIキーを持っている人は、書き込みを含め、サーバー上のすべてのツールをワークスペースのデータに対して実行できます。OAuthを優先し、キーを共有リポジトリに含めず、クライアントが対応している場合は環境変数を使用してください。

動作を確認する#

エージェントに簡単なことを尋ねてみましょう。「AmICitedのドメインを一覧表示して」。エージェントが list_domains を呼び出し、ドメインを名前付きで返すはずです。次に、「過去30日間のAIでの可視性を表示して」 を試してください。これには prompt_analytics が使われます。

接続が拒否された場合、多くはメッセージに理由が示されます。

  • プラン。 「requires a Pro plan or above」: ワークスペースのオーナーのプランにMCPが含まれていません。
  • クレジット。 ワークスペースの残高がゼロまたはマイナスです。チャージして再試行してください。
  • レート制限。 ツール呼び出しは、ワークスペースごとに1時間あたりの上限があります。トライアルは120回、Proは600回、Premiumは2,000回、Enterpriseは無制限です。メッセージにはウィンドウがリセットされる時刻が示されます。ツールの一覧表示とスキルの読み取りはカウントされません。

関連ページ#