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アプリでも利用できます。
- Claudeのコネクタ設定を開きます。
- + をクリックし、Add custom connector を選びます。
https://api.flowhunt.io/mcp/amicited を貼り付け、Add をクリックします。- 新しいコネクタで 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のワークスペースでは、管理者が有効にする必要がある場合があります。
- OpenAIのコネクタに関するドキュメントの手順に従って、Developer modeをオンにします。
- ChatGPTで Settings を開き、Apps & Connectors を選びます。
- カスタムコネクタを追加し、
https://api.flowhunt.io/mcp/amicited を貼り付けます。 - 開いたブラウザウィンドウでアクセスを承認します。
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は無制限です。メッセージにはウィンドウがリセットされる時刻が示されます。ツールの一覧表示とスキルの読み取りはカウントされません。
関連ページ#
# MCPサーバーに接続する
Claude、Claude Code、ChatGPT、Cursor、VS Code、Codexを、MCP経由でAmICitedのワークスペースに接続します。URLは1つ、サインインはOAuth、代替としてAPIキーも使えます。
AmICitedは、常時稼働するMCP(Model Context Protocol)サーバーを提供しています。AIクライアントを接続すると、可視性データの読み取りやレポートの実行ができ、書き込み権限があれば、プロンプトの追加、記事の生成、アノテーションの記録も、通常の会話の中で行えます。ダッシュボードのすべての機能はMCPツールとしても提供されているため、アプリでできることは、エージェントにもすべてできます。
## 始める前に
- **MCPを含むプラン。** MCPは、7日間のトライアルと、Pro、Premium、Enterpriseで利用できます。Starterのワークスペースではサーバーのurlを確認できますが、プランをアップグレードするまで接続は拒否されます。[プランと上限](/docs/account/plans-and-limits/)をご覧ください。
- ワークスペースでの**編集者以上の権限**。権限のないメンバーには、**MCP** ページでワークスペースのオーナーまたは管理者に依頼するよう案内が表示されます。
- **プラスのクレジット残高。** MCP経由の読み取りは無料ですが、エンドポイントは応答する前にワークスペースにクレジットがあるかを確認します。[クレジット](/docs/account/credits/)をご覧ください。
## サーバーURL
URLは全員共通で1つです。
```text
https://api.flowhunt.io/mcp/amicited
```
ワークスペースはURLに含まれません。認証情報から決まります。OAuthでは同意画面でワークスペースを選び、APIキーはすでに1つのワークスペースに属しています。アプリの **MCP** ページからもURLをコピーできます。ページには **Copy URL** ボタンと、以下と同じクライアントごとの手順が表示されます。トランスポートはストリーミング可能なHTTPです。
## クライアントを接続する
お使いのクライアントを選んでください。各タブは、推奨のOAuthサインインから始まり、代替のAPIキーで終わります。
claude.aiで追加したコネクタは、Claude Desktopアプリでも利用できます。
1. [Claudeのコネクタ設定](https://claude.ai/customize/connectors)を開きます。
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を再起動します。
```json {title="claude_desktop_config.json"}
{
"mcpServers": {
"amicited": {
"type": "http",
"url": "https://api.flowhunt.io/mcp/amicited",
"headers": {
"Authorization": "Bearer <your-workspace-api-key>"
}
}
}
}
```
ターミナルからサーバーを1回登録します。
```bash
claude mcp add --transport http amicited https://api.flowhunt.io/mcp/amicited
```
その後、Claude Code内で `/mcp` を実行し、**Authenticate** を選んで、開いたブラウザウィンドウでアクセスを承認します。
**APIキーの代替。** `~/.claude.json` のトップレベルの `mcpServers` キーの下にサーバーを追加し、Claude Codeを再起動します。
```json {title="~/.claude.json"}
{
"mcpServers": {
"amicited": {
"type": "http",
"url": "https://api.flowhunt.io/mcp/amicited",
"headers": {
"Authorization": "Bearer <your-workspace-api-key>"
}
}
}
}
```
カスタムMCPコネクタには**Developer mode**が必要で、有料のChatGPTプラン(Plus、Pro、Team、Enterprise)で利用できます。Business、Enterprise、Eduのワークスペースでは、管理者が有効にする必要がある場合があります。
1. [OpenAIのコネクタに関するドキュメント](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt)の手順に従って、Developer modeをオンにします。
2. ChatGPTで **Settings** を開き、**Apps & Connectors** を選びます。
3. カスタムコネクタを追加し、`https://api.flowhunt.io/mcp/amicited` を貼り付けます。
4. 開いたブラウザウィンドウでアクセスを承認します。
**APIキーの代替。** 手順4で、代わりにAPIキー認証を選び、ワークスペースのAPIキーを貼り付けます。コネクタを保存し、新しいチャットで有効にします。
アプリの **MCP** ページで **Cursor** を選び、**Add to Cursor** をクリックします。Cursorがサーバーをインストールし、サインインも実行します。
ボタンでCursorが開かない場合は、CursorのMCP設定から手動でサーバーを追加するか、`~/.cursor/mcp.json`(またはプロジェクトごとの `.cursor/mcp.json`)を編集します。
```json {title="~/.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は**Agentモードの GitHub Copilot**を通じてサーバーを利用するため、Copilotが有効になっている必要があります。
アプリの **MCP** ページで **VS Code** を選び、**Add to VS Code** をクリックします。VS Codeがサーバーをインストールし、サインインも実行します。
手動で追加するには、コマンドパレットを開いて **MCP: Open User Configuration** を実行し、`servers` の下にサーバーを追加します。
```json {title="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は、標準的なリモートMCPクライアントとして接続します。サーバーを追加してから、サインインします。
```bash
codex mcp add amicited --url https://api.flowhunt.io/mcp/amicited
codex mcp login amicited
```
または、`~/.codex/config.toml` を直接編集します。
```toml {title="~/.codex/config.toml"}
[mcp_servers.amicited]
url = "https://api.flowhunt.io/mcp/amicited"
oauth_resource = "https://api.flowhunt.io/mcp/amicited"
```
**APIキーの代替。** キーを環境変数に設定し、Codexにそれを指定します。
```toml {title="~/.codex/config.toml"}
[mcp_servers.amicited]
url = "https://api.flowhunt.io/mcp/amicited"
bearer_token_env_var = "AMICITED_API_KEY"
```
厳格な承認設定でCodexを実行していても、すべての読み取り専用ツールには `read_tool` を通じて引き続きアクセスできます。[ツールセットとツール](/docs/mcp/toolsets/)をご覧ください。
## 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キーを持っている人は、書き込みを含め、サーバー上のすべてのツールをワークスペースのデータに対して実行できます。OAuthを優先し、キーを共有リポジトリに含めず、クライアントが対応している場合は環境変数を使用してください。
## 動作を確認する
エージェントに簡単なことを尋ねてみましょう。*「AmICitedのドメインを一覧表示して」*。エージェントが `list_domains` を呼び出し、ドメインを名前付きで返すはずです。次に、*「過去30日間のAIでの可視性を表示して」* を試してください。これには `prompt_analytics` が使われます。
接続が拒否された場合、多くはメッセージに理由が示されます。
- **プラン。** 「requires a Pro plan or above」: ワークスペースのオーナーのプランにMCPが含まれていません。
- **クレジット。** ワークスペースの残高がゼロまたはマイナスです。チャージして再試行してください。
- **レート制限。** ツール呼び出しは、ワークスペースごとに1時間あたりの上限があります。トライアルは120回、Proは600回、Premiumは2,000回、Enterpriseは無制限です。メッセージにはウィンドウがリセットされる時刻が示されます。ツールの一覧表示とスキルの読み取りはカウントされません。
## 関連ページ
300以上のツールをすべて読み込まずに、エージェントが適切なツールを見つける方法です。ブリーフィング、低下、ギャップ、記事のための、コピーして使えるプロンプトです。複数ステップの質問の前に、エージェントが読む組み込みのプレイブックです。MCPを含むプランと、各プランで許可される内容です。
Source: https://www.amicited.com/ja/docs/mcp/connect/