YourICP

YourICP MCP サーバー

YourICPの連絡先エンリッチメントおよびオーディエンスターゲティング API 用の、公式オープンソースModel Context Protocol （MCP）サーバーです。Claude などの AI アシスタントが、会話から直接連絡先をエンリッチメントし、オーディエンスを構築できます。

---

実行方法は 2 通りあります

	このリポジトリ（@youricp/mcp）	ホスト型コネクター
トランスポート	stdio、お使いのマシン上で実行	Streamable HTTP
認証	API トークンを貼り付け	OAuth 2.0 + PKCE、ブラウザーでログイン
ツール	連絡先のエンリッチメント	エンリッチメントおよびオーディエンス構築
料金	既存の YourICP プラン	従量課金、またはお使いのプラン
セットアップ	JSON 設定ファイルを編集	URL を 1 つ貼り付け

特に自分でコードを実行したい場合を除き、ホスト型コネクターをお使いください。インストール不要で、常に最新の状態に保たれ、オーディエンス構築ツールを利用できる唯一の選択肢です。

https://mcp.youricp.com/sse

Claude の 設定 → コネクター → カスタムコネクターを追加から追加してください。依頼できる内容については、コネクターユーザーガイドをご覧ください。

コードを読んだり変更したり、セルフホストしたり、自分のトークンを使って完全にオフラインで実行したり、stdio のみをサポートするクライアントを使ったりする場合は、このリポジトリをお使いください。これは意図的に小規模にしたリファレンス実装で、決済、OAuth、ホスティングのインフラストラクチャは不要です。

---

ツール

ツール	説明
set_auth_token	このセッション用に YourICP 認証トークンを設定します
set_token	set_auth_token の非推奨エイリアスです
submit_lookup	メールアドレスまたは LinkedIn URL から連絡先をエンリッチメントします（jobId を返します）
check_lookup	jobId のエンリッチメント結果をポーリングします

---

要件

• Node.js 18 以降
• YourICP 認証トークン — app.youricp.comで取得してください

クイックスタート（インストール不要）

npx で直接実行できます。クローンも、グローバルインストールも不要です。

YOURICP_AUTH_TOKEN=your_auth_token_here npx @youricp/mcp

Claude Desktop で使用する

これを claude_desktop_config.json に追加すると、npx がサーバーを自動的に取得して実行します。

{
  "mcpServers": {
    "youricp": {
      "command": "npx",
      "args": ["-y", "@youricp/mcp"],
      "env": {
        "YOURICP_AUTH_TOKEN": "your_auth_token_here"
      }
    }
  }
}

Claude Desktop を再起動すると、YourICP ツールが表示されます。

グローバルインストール（任意）

npm install -g @youricp/mcp
YOURICP_AUTH_TOKEN=your_auth_token_here youricp-mcp

ソースから実行する

git clone https://github.com/youricp/mcp-server.git
cd mcp-server
npm install
YOURICP_AUTH_TOKEN=your_auth_token_here npm start

または、.env.example を .env にコピーして必要事項を入力し、npm start を実行してください。

---

設定

変数	デフォルト	説明
YOURICP_API_URL	https://app.youricp.com	YourICP API のベース URL
YOURICP_AUTH_TOKEN	(なし)	YourICP 認証トークン
YOURICP_API_TOKEN	(なし)	YOURICP_AUTH_TOKEN の非推奨エイリアスです。引き続き読み込まれますが、非推奨の通知がログに記録されます。

2 種類のトークン

YourICP では、互いに無関係な 2 種類のものに「トークン」という言葉を使うため、このサーバーでは常にどちらを指しているのかを明示します。

• 認証トークン — 利用者の身元を証明する API 認証情報です。YOURICP_AUTH_TOKEN と set_auth_token で設定するのはこちらです。
• 課金トークン — エンリッチメント作業に使う YourICP のプリペイド通貨で、課金トークン 100 個が $1.00 に相当します。このリファレンスサーバーがこれを扱うことはありません。

コントリビューション

コントリビューションを歓迎します。CONTRIBUTING.mdと行動規範をお読みください。セキュリティ上の問題を報告する場合は、SECURITY.mdをご覧ください。

ライセンス

MIT © YourICP