ElidoをあらゆるAIエージェントに接続。
Elido MCPは、リンク、QR、分析APIをMCPツールとして公開するオープンソースサーバーです。Claude Desktop、Cursor、または自社エージェントに30秒で導入可能です。
MCPとは?
Model Context ProtocolはAnthropicによるオープンスタンダードで、AIエージェントがツール、ファイル、APIと構造化された方法で通信できるようにします。1つのプロトコルで多くのクライアントに対応します。
MCP以前は、AIエージェントを外部サービスに接続するには、カスタムプロンプト指示の記述、手動作成のツールスキーマの維持、モデルが正しく呼び出すことへの期待が必要でした。MCPはそれを標準化されたプロトコルに置き換えます:サーバーがJSONスキーマでツールを宣言し、クライアントが自動的に発見し、すべての呼び出しが型付けされて監査可能。1つのプロトコルがClaude Desktop、Cursor、Claude Code、Continue.dev、および他のMCP対応クライアント全てで機能します。
Elido MCPサーバーはあなたの環境内でローカルに動作します。APIキーを保持し、エージェントからの構造化ツールコールをapi.elido.appへのRESTリクエストに変換し、構造化された結果を返します。エージェントはあなたのキーを見ません;api.elido.appはモデルと直接通信しません。
ランタイムフロー
チャットメッセージからElido APIへ、そして戻る
シーケンスは4ステップです。各ステップは高速 - MCPレイヤーは5ms未満のオーバーヘッドを追加。api.elido.appへのRESTコールはEUから30〜80msかかります。alt-tabでブラウザに移動する前にチャットで結果が確認できます。
仕組み
MCPは軽量なワイヤープロトコルです。サーバーはお客様の環境で動作し、APIキーを保持し、エージェントからの構造化されたツール呼び出しを api.elido.app へのRESTリクエストに変換します。
- 1. エージェントがツールを要求する
起動時にMCPクライアント(Claude Desktop、Cursor、独自エージェントなど)がElidoサーバーにツールカタログを要求します。サーバーは利用可能なすべてのツール(名前、パラメータ、戻り値の形式)をJSON-Schema形式で返します。
- 2. ユーザーがチャットでリクエストする
あなたが「タグ launch-2026 を付けてこのURLを短縮して」と言うと、エージェントはカタログと照合し、構造化された引数で create_link を呼び出すことを決定します。クライアントが対応していれば(Claude Desktopなど)、実行前にツール呼び出しの内容が表示されます。
- 3. サーバーが api.elido.app にアクセスする
ローカルのMCPサーバーは、あなたの ELIDO_API_KEY でリクエストに署名し、対応するRESTエンドポイントを呼び出します。レイテンシの大部分は api.elido.app への往復(EUからは通常30〜80ms)であり、MCP層のオーバーヘッドは5ms未満です。
- 4. 結果がエージェントに返される
レスポンスは構造化されたツール結果として返され、エージェントはそれを引用、要約、または次の呼び出しへの連鎖に使用できます。エラーには実用的なメッセージ(レート制限のヒント、スコープ不足、未検出など)が含まれるため、エージェントはユーザーに頼らずに復旧を試みることができます。
利用可能なツール
すべてのツールはJSONスキーマで型付けされています。エージェントは起動時にパラメーター名、型、説明を確認します。手動のプロンプトエンジニアリングは不要です。
セッション例
インストール後の様子
これはElido MCPサーバーを追加した後の実際のClaude Codeセッションです。エージェントは起動時にツールを発見します。そこから、平易な言葉で十分です。
$ claude
> What tools do you have available?
Claude: I have access to the Elido MCP server with these tools:
- create_link: Shorten a URL with optional slug, domain, and tags
- list_links: Search and filter links by tag, folder, or query
- get_link_analytics: Click counts, geo, devices, conversions
- create_qr: Generate a QR code for a short link
- list_workspaces: Enumerate accessible workspaces
> Shorten https://elido.app/pricing with tag launch-2026
Claude: [calling create_link with {url, slug: "pricing-launch", tags: ["launch-2026"]}]
Result: eldo.link/pricing-launch · 0 clicks · audit loggedツールコールはClaude DesktopとClaude Codeで実行前に表示されます。エージェントが渡す引数を正確に確認できます。コールが実行される前にキャンセルできます。
チームによる活用事例
本番環境で見られる3つのパターン。チームの現在の作業スタイルに合うものを選んでください。
なぜ直接のAPI呼び出しではなく、MCPなのですか?
どちらのアプローチも同じElidoエンドポイントに到達します。違いはセットアップ時間、セキュリティ体制、そしてエージェントの推論の読みやすさにあります。
| 全機能を徹底比較 | Elido MCP | Direct REST | Browser only |
|---|---|---|---|
| セットアップ時間 | 30秒(設定 + キー) | カスタムプロンプト + ツール定義(数時間) | 手動での貼り付け / スクレイピング(自動化なし) |
| ツールカタログ | 自動検出、JSON-Schemaによる型定義 | 手書き、APIの進化に伴う乖離 | なし - エージェントによる推測が必要 |
| APIキーの取り扱い | ローカルサーバーの環境変数に保持 | プロンプトに貼り付け(漏洩のリスク) | ダッシュボードに貼り付け(クッキーに紐付け) |
| 監査証跡 | チャット履歴内の構造化されたツール呼び出し | フリーテキスト - 後から検索が困難 | ブラウザ履歴 - 意図を把握できない |
| 複数クライアントでの再利用 | 1つの設定で、複数のMCP対応クライアントを利用可能 | クライアントごとに再プロンプト | ブラウザごとの状態、ポータビリティなし |
テスト済みクライアント
安定性評価は、リリースごとに各クライアントに対して実行する内部テストスイートに基づいています。「安定」はツールカタログ全体がパスすることを意味します。「ベータ」は動作するがエッジケース(ストリーミング結果、長いリスト)が予期しない動作をする可能性があることを意味します。
セキュリティ
デフォルトは読み取り専用。キーはローカルに保持。
セキュリティモデルは最小スコープ原則に従います。デフォルトインストールは読み取り専用アクセス。すべての変更はログに記録されます。APIキーはローカルサーバープロセスから外に出ません。
キーの分離
ELIDO_API_KEYはサーバーの環境変数に存在 - プロンプトには含まれず、モデルに送信されません。モデルがツールを呼び出し、サーバーがリクエストに署名します。モデルの会話が侵害されてもキーは露出しません。
スコープゲーティング
デフォルトは読み取り専用。書き込みまたは削除アクセスの付与には、意図的なワークスペース設定が必要です。書き込みが有効な場合でも、すべての変更は呼び出しキーとともにワークスペース監査ログに表示されます。
オープンソース
サーバーはgithub.com/elidoapp/mcp-serverでMITライセンス。デプロイ前にソースを確認できます。一般的なフォークはワークスペース固有のエンリッチメントや内部ツールコールを追加します。
30秒でインストール
サーバーはローカルで動作し、ワークスペースのAPIキーで認証します。api.elido.appへの通常の呼び出し以外、データがマシンから出ることはありません。
- 1クライアント設定にサーバーを追加
- 2ELIDO_API_KEYを設定(設定 → APIキー で発行)
- 3クライアントを再起動。エージェントのツールリストにElidoが表示されます。
{
"mcpServers": {
"elido": {
"command": "npx",
"args": ["-y", "@elido/mcp-server"],
"env": { "ELIDO_API_KEY": "elido_pk_..." }
}
}
}同じスニペットがCursorでも機能します - .cursor/mcp.jsonに追加してください。Claude Codeの場合は、プロジェクトの.mcp.jsonに追加します。APIキーは設定 → APIキーで発行します。ほとんどのワークフローには読み取り専用スコープで十分です。
よくある質問
データは自分のマシンから外に出ますか?+
api.elido.app に対して行う呼び出し以外は出ません。MCPサーバーは stdio(デフォルト)またはローカルの SSE です。勝手に外部に送信したり、テレメトリを収集したりすることはありません。ソースコードはGitHubで公開されており、検証可能です。ダッシュボードと同じEU居住規則が適用されます。
エージェントが誤ってリンクを削除してしまうことはありますか?+
デフォルトのインストール設定ではあり得ません。デフォルトは読み取り専用モードです。書き込み/削除の許可には、ワークスペースの設定を意図的に変更する必要があります。書き込みを有効にしても、すべての変更は呼び出したAPIキーと共に監査ログに記録されます。
どのクライアントがサポートされていますか?+
Claude Desktop、Cursor、Claude Codeは安定しています。Continue.devはベータ版です。stdioまたはSSEを介してMCP 0.1.0を話すクライアントであれば動作します。リファレンスクライアントの実装に対してテストを行っています。
レート制限はどうなっていますか?+
ワークスペースのAPIキーと同じです。持続的に100リクエスト/秒、バーストで200リクエスト/秒です。429エラーが発生すると Retry-After を伴って制限されます。MCPサーバーは429をツールエラーとしてそのまま渡すため、エージェントは待機(バックオフ)を試みることができます。追加の制限レイヤーはありません。
/ai/llmにあるLLM連携とどう違うのですか?+
レイヤーが異なります。/ai/llmは一般ユーザー向け(カスタムGPT、Slackボット、ディープリンクボタン)で、構築済みですぐに使えます。MCPはそれらの下に位置する開発者向けプロトコルです。これらの連携機能はMCPの上に構築することが可能で、多くのサードパーティクライアントが実際にそうしています。
独自のフォークを動かすことはできますか?+
はい。リポジトリはMITライセンスです。一般的なフォークでは、カスタムツール(ワークスペース固有のメタデータ補完、Notion/Linearへの内部リンクなど)が追加されています。もし便利なツールを作成された場合は、ぜひIssueを作成してください。広く有用なツールは本体に取り込みたいと考えています。
エアギャップ環境(隔離環境)で動作しますか?+
セルフホスト版Elidoであれば動作します。MCPサーバーは当社のAPIエンドポイントへのネットワークアクセスのみを必要とするため、プライベートVPC内でも動作可能です。パブリッククラウド版Elidoの場合は、他のAPIクライアントと同様に api.elido.app への外向き通信が必要です。
APIキーのセキュリティモデルはどうなっていますか?+
「必要最小限のスコープ」の原則が適用されます。単一のワークスペースに限定したスコープでキーを発行し、クライアントが固定IPから実行される場合はIP制限をかけ、四半期ごとに更新してください。キーが漏洩した場合の被害範囲は、通常のAPIキーの漏洩と同じです(ワークスペース内に限定、監査ログに記録、無効化可能)。
30秒でセットアップ完了
スニペットをClaude DesktopやCursorに貼り付け、再起動するだけで、エージェントのカタログにツールが表示されます。