Quidli Connect

Quidli Connect MCP

オンチェーンの評判を活用した、マルチプレイヤーエージェント向けのオープンな決済機能です。ソーシャルハンドルをウォレットに解決し、オンチェーンの評判を確認して、トークンを送信できます。Cursor、Claude Desktop、Claude Code、またはMCP対応のクライアントから利用できます。

マルチプレイヤーとは、互いに面識のない当事者同士を指します。エージェントが人または別のエージェントに支払いを行う場合、事前の関係も、いざというときに頼れるアカウントもありません。Connectを使えば、送信前に相手が誰なのかを確認できます。

公開リポジトリ：github.com/Quidli/connect-mcp

1つのコマンドですぐに試す

APIキーは不要です。

Claude Code:

claude mcp add --transport http quidli https://mcp.connect.quid.li/

Cursor: Cursorに追加（または、このリンクをSettings → MCP → Add new MCP serverに貼り付けます）

Claude Desktop: Settings → Connectors → Add custom connectorを選択し、URLにhttps://mcp.connect.quid.liを指定します。

ローカル（任意のクライアント） — ホストされたエンドポイントの代わりに、マシン上で実行します。

npx -y @quidli/connect-mcp

APIキー、x402ウォレットの従量課金、設定例の全体については、以下の接続方法を選ぶをご覧ください。

続いて、エージェントに次のように尋ねます。

GitHubハンドルjustinquidliをウォレットに解決してください。

{
  "status": "completed",
  "results": [
    {
      "type": "github",
      "value": "justinquidli",
      "ethWalletAddress": "0x6a48ADE3bE3F9f0b8B4c9af61Bb654A219311699",
      "solWalletAddress": "8vo1awED98mwqDa4qR9JyMsk7qJYiwnTSG4EnXGyWXRh"
    }
  ]
}

GitHub、X、Telegram、Discord、LinkedIn、Farcaster、メールアドレス、電話番号を対象に解決します。また、Quidliを利用したことのない人向けにウォレットを生成します。

見つけた情報をスコアリングするには、connect_scores_batchを使います。複数のIDのオンチェーン評判をまとめて返します。

検索、スコア、価格の確認は、共通の匿名枠の範囲内でAPIキーなしで利用できます。Connect APIキーを追加すると、利用上限が増え、自分のプロフィール（connect_me）とSmart Sendを使えるようになります。

---

接続方法を選ぶ

	ホスト型（mcp.connect.quid.li）	ローカル（npx @quidli/connect-mcp）
セットアップ	MCPの設定にURLを追加します	npxでローカルプロセスを実行します
認証	APIキーは任意です。キーなしの場合：共通の匿名枠の範囲内で検索／スコアを利用でき、価格／チェーン情報は公開されています	APIキー、x402の従量課金、または検索／スコアのみなら認証なしでも利用できます
利点	インストール不要。キーなしですぐに試せます。Quidliのインフラ上で常時稼働します	ウォレットの秘密鍵がマシンの外に出ません。APIキーの代わりにUSDCで呼び出しごとに支払えます
欠点	匿名トラフィックはグローバルなレート制限を共有します。従量課金には対応していません	Node.js 20+が必要です。初回実行時にnpxがパッケージをダウンロードすることがあります
制限事項	x402／ウォレット認証は利用できません — ホスト型エンドポイントに秘密鍵を送信しないでください	x402モードにはBase上のUSDCが必要です（メインネット8453）。connect_dropにはAPIキーが必要です

connect.quid.liでConnect APIキーを取得し、Enable API accessを有効にすると、利用上限が増え、connect_meとSmart Sendを使えるようになります。

---

ホスト型（推奨）

ローカルでのセットアップは不要です。検索、スコア、エージェント、価格の確認は、APIキーなしで利用できます（共通の匿名枠）。キーを追加すると、利用上限が増え、自分のプロフィール（connect_me）とSmart Sendを使えるようになります。

Cursor

すでにほかの MCP サーバーを使用している場合： ディープリンクはスキップして手動で追加してください。一部の Cursor バージョンでは、ワンクリックインストールによって mcp.json 全体が上書きされる場合があります。

Cursor に追加

または、Cursor Settings → MCP → Add new MCP server に貼り付けてください。

cursor://anysphere.cursor-deeplink/mcp/install?name=quidli-connect&config=eyJ1cmwiOiJodHRwczovL21jcC5jb25uZWN0LnF1aWQubGkifQ==

手動で追加 {#cursor-manual}

既存のエントリーは置き換えず、~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）の mcpServers にこれをマージしてください。

"quidli-connect": {
  "url": "https://mcp.connect.quid.li"
}

オプション — 上限の引き上げと Smart Send：

"quidli-connect": {
  "url": "https://mcp.connect.quid.li",
  "headers": {
    "x-api-key": "<your-connect-api-key>"
  }
}

Claude Desktop

1. Claude → Settings → Connectors を開きます（古いバージョンでは Settings → Developer → Edit Config を開きます）。
2. URL https://mcp.connect.quid.li を指定して、カスタム MCP コネクターを追加します。必要に応じて、ヘッダー x-api-key: <your-connect-api-key> を設定します。

または、これを設定ファイルにマージして Claude を再起動します。

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "quidli-connect": {
      "url": "https://mcp.connect.quid.li"
    }
  }
}

お使いの Claude バージョンがリモートの url コネクターに対応していない場合は、代わりにローカルブリッジを使用してください（API は引き続きホスト型で、小さなローカルヘルパーを実行します）。

{
  "mcpServers": {
    "quidli-connect": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "--http",
        "https://mcp.connect.quid.li"
      ]
    }
  }
}

ブリッジには Node.js 20+ が必要です。保存後、Claude Desktop を再起動してください。ツールが利用可能になると、チャット入力欄にハンマーのアイコンが表示されます。

キーがなくても、initialize / tools/list は常に成功します。匿名の tools/call は共有のグローバルクォータを使用します（上限を超えると HTTP 429 が返されます。上限を引き上げるにはキーを取得してください）。プレースホルダーキーでは 401 が返されます。

---

Grok

1. grok.com/connectors にアクセスして、Custom を選択します。
2. サーバー URL として https://mcp.connect.quid.li を入力します。

これにより、共有クォータの範囲内で、匿名ティアのツール（lookup、scores、agent、price）を Grok から利用できます。

現在の制限： Grok のカスタムコネクター UI は、現時点で API キーやカスタムヘッダーの設定に対応していません。そのため、connect_me、connect_drop、connect_drop_balance（いずれも API キー必須）はまだ Grok から利用できず、呼び出すと認証エラーが返されます。これは connect-mcp の制限ではなく、Grok のカスタムコネクター設定で現時点では認証フィールドを指定できないことが原因です。

---

Smithery

Smithery をすでに利用している場合は、認証とセッションを Smithery が処理します。Smithery アカウントが必要です。

npx smithery login
npx smithery mcp add quidli/connect

---

ローカル（stdio）

ウォレットを使って呼び出しごとに支払いたい場合や、ローカルの env ファイルに認証情報を保存したい場合に最適です。

Node.js 20+ が必要です。

Cursor

以下のいずれかを .cursor/mcp.json（プロジェクト）またはグローバルの MCP 設定に追加してください。

オプション A — API キー

ホスト型と同じ課金モデルです。認証情報はお使いのマシンに保存されます。

{
  "mcpServers": {
    "quidli-connect": {
      "command": "npx",
      "args": ["-y", "@quidli/connect-mcp"],
      "env": {
        "CONNECT_API_KEY": "<your-connect-api-key>",
        "CONNECT_API_BASE_URL": "https://api.connect.quid.li"
      }
    }
  }
}

オプション B — x402 従量課金（ウォレット）

API キーは不要です。API が HTTP 402 を返すと、認証済みの呼び出しは自動的に支払われます。ウォレットの秘密鍵が読み取られるのはローカルプロセスのみです。

{
  "mcpServers": {
    "quidli-connect": {
      "command": "npx",
      "args": ["-y", "@quidli/connect-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x<wallet-with-usdc-on-base>",
        "CONNECT_API_BASE_URL": "https://api.connect.quid.li",
        "CONNECT_X402_EVM_NETWORK": "8453"
      }
    }
  }
}

ステージング API を指定する場合は、Base Sepolia に 84532 を使用してください。

オプション C — 認証情報なし（lookup / scores）

MCP プロセスは CONNECT_API_KEY または EVM_PRIVATE_KEY がなくても起動します。connect_lookup、connect_scores_*、connect_get_price、connect_get_chains は認証なしで API を呼び出します。x402 が無効（price が 0。ローカルでは通常この状態）であれば成功します。x402 が有効な本番環境では、キーまたはウォレットを設定するまで、これらのツールは HTTP 402 を返します。

connect_me、connect_drop、connect_drop_balance には引き続き CONNECT_API_KEY が必要です。

{
  "mcpServers": {
    "quidli-connect": {
      "command": "npx",
      "args": ["-y", "@quidli/connect-mcp"],
      "env": {
        "CONNECT_API_BASE_URL": "http://127.0.0.1:3011"
      }
    }
  }
}

Claude Desktop

1. Claude → Settings → Developer → Edit Config を開きます（表示されない場合は、先に Developer モードを有効にしてください）。
2. 以下のいずれかのブロックを、次のファイルの mcpServers にマージします。

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

3. Claude Desktop を再起動します。

オプション A — API キー

{
  "mcpServers": {
    "quidli-connect": {
      "command": "npx",
      "args": ["-y", "@quidli/connect-mcp"],
      "env": {
        "CONNECT_API_KEY": "<your-connect-api-key>",
        "CONNECT_API_BASE_URL": "https://api.connect.quid.li"
      }
    }
  }
}

オプション B — x402 の従量課金（ウォレット）

{
  "mcpServers": {
    "quidli-connect": {
      "command": "npx",
      "args": ["-y", "@quidli/connect-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x<wallet-with-usdc-on-base>",
        "CONNECT_API_BASE_URL": "https://api.connect.quid.li",
        "CONNECT_X402_EVM_NETWORK": "8453"
      }
    }
  }
}

CONNECT_API_KEY と EVM_PRIVATE_KEY の両方が設定されている場合は、API キーが使用されます。

ローカルモードでは認証情報は任意です。どちらの環境変数も設定されていなくても、API が x402 の料金を請求しない場合は、検索とスコアの取得は引き続き機能します。connect_me と Smart Send ツールには CONNECT_API_KEY が必要です。

---

トラブルシューティング

バックグラウンドサービスから実行すると、npx が出力なしで停止する

通常の対話型シェルを使わずに実行するクライアント設定など、バックグラウンドのプロセスマネージャー（macOS の launchd エージェント、systemd ユニット、スーパーバイザーなど）から npx を介して @quidli/connect-mcp を起動すると、出力もエラーもないまま無期限に停止することがあります。クラッシュではありません。対話型ターミナルと同じシェル初期化が行われない環境で、npx が PATH の解決に行き詰まっています。

回避策： Bun がインストールされている場合は、npx の代わりに bunx を使用してください。ローカルにインストールせずにパッケージを実行するという同じ処理を行いますが、PATH が制限された環境でこの停止は発生しません。

{
  "mcpServers": {
    "quidli-connect": {
      "command": "bunx",
      "args": ["-y", "@quidli/connect-mcp"],
      "env": {
        "CONNECT_API_KEY": "your-api-key"
      }
    }
  }
}

クライアントの MCP 設定を介さずに自分でプロセスを起動しており、bunx も PATH にない場合に備えたい場合は、まず絶対パスで解決してください。

import { spawn } from "node:child_process";
import { existsSync } from "node:fs";
import { homedir } from "node:os";
import { join } from "node:path";

const BUNX_PATH = (() => {
  const candidate = join(homedir(), ".bun", "bin", "bunx");
  return existsSync(candidate) ? candidate : "bunx";
})();

const proc = spawn(BUNX_PATH, ["-y", "@quidli/connect-mcp"], {
  stdio: ["pipe", "pipe", "pipe"],
});

これは、Bun が npm より優れているという一般的な主張ではありません。対話型シェルの外部で npx を起動したときに発生する、特定の再現可能な障害への対策です。

API キーの環境変数名が間違っている

API_KEY ではなく CONNECT_API_KEY を設定していることを確認してください。サーバーが読み取るのは CONNECT_API_KEY のみです。名前が一致しない場合もエラーは表示されず、呼び出しはエラーになるのではなく、匿名・未認証モードで実行されます。そのため、設定ミスではなく、正常に動作しているものの機能が不自然に制限された接続のように見えることがあります。

対応チェーン

connect_get_chains（REST：GET /chains）が信頼できる情報源であり、キーは不要です。2026-10-14 時点では、以下のメインネットが一覧にあり、いずれも lookup と drop が有効です。

チェーン	チェーン ID	ネイティブトークン
Ethereum	1	ETH
Base	8453	ETH
Polygon	137	POL
OP Mainnet	10	ETH
Arbitrum One	42161	ETH
Avalanche	43114	AVAX
World Chain	480	ETH
Monad	143	MON
Robinhood Chain	4663	ETH
Solana	1399811149	SOL

World Chain Sepolia（4801）もテストネットとして一覧にあります。

• ソーシャルハンドルはすべてのチェーンで解決されます。EVM チェーンでは受取人の ethWalletAddress に、Solana では受取人の solWalletAddress に支払われます。
• tokenContract を省略した場合、connect_drop はネイティブトークンを送信します。ERC-20 または SPL トークンの場合は、そのコントラクトアドレスまたはミントアドレスを渡します。
• 残高の対応状況はチェーンによって異なります。 connect_drop_balance はすべてのチェーンでネイティブ残高を返します。ERC-20 残高はチェーンごとのプロバイダーから取得されます。Monad と Base では Moralis、Robinhood Chain では Blockscout が使用されます。その他のチェーンでは、ネイティブトークンと注目トークンのみが返される場合があります。残高がゼロのトークンは省略され、スパムトークンが表示されることがあります。また、プロバイダーがインデックス化していないトークンは表示されない場合があります。コントラクトアドレスが分かっていれば、tokenContract に渡して送信できます。

ツール

ツール	機能
connect_get_price	参照価格を一覧表示します（認証不要）
connect_get_chains	対応チェーンと機能の互換性を一覧表示します（認証不要）
connect_lookup	ソーシャル ID を EVM および SOL のウォレットアドレスに解決します
connect_lookup_exposed	受取人が Connect 上で公開しているプラットフォームを一覧表示します
connect_scores_batch	アカウントまたはユーザー名のスコアを一括取得します
connect_scores_by_account	リンク済みアカウント 1 件のスコアを取得します
connect_scores_by_username	Connect のユーザー名でスコアを取得します
connect_me	API キー所有者のプロフィール、スコア、リンク済みアカウント — API キーのみ
connect_drop	スマート送金（EVM の一括送金または Solana の SOL／SPL）。trustFilter を指定すると、信頼グラフに基づいて受取人を制限できます — API キーのみ
connect_drop_balance	チェーン上のスマート送金ウォレット残高 — API キーのみ。トークンの対応状況はチェーンによって異なります。対応チェーンを参照してください
connect_trust_create	オンチェーンの信頼アテステーションを作成します（Base 上の EAS）— API キーのみ
connect_trust_check	ID が深度 1 の信頼グラフに含まれているか確認します
connect_trust_graph	ID の送信側／受信側の信頼エッジを一覧表示します
connect_trust_revoke	対象別に有効な信頼アテステーションを取り消します — API キーのみ

Connect のデータや操作が必要な場合は、クライアントにこれらのツールを使うよう依頼してください。

コントリビューション

このリポジトリは読み取り専用のミラーで、リリースのたびに再生成されます。ここにコミットした変更は上書きされます。プルリクエストではなく、イシューを作成してください。 CONTRIBUTING.mdを参照してください。