Kordi

Kordi MCP Server

あらゆる AI エージェントから、ストリーミングサービスや SaaS のサブスクリプションを追跡、分析し、管理できます。

Kordi は、サブスクリプションのインテリジェンスプラットフォームです。この Model Context Protocol サーバーを使うと、Claude Desktop、Cursor、Raycast、または独自のエージェントなど、MCP 対応の AI クライアントから、ユーザーが追跡しているサブスクリプションの確認、請求状況の評価、節約方法の提示、解約・一時停止リンクの生成、新たに見つかったサブスクリプションの登録ができます。

これはホスト型のリモート MCP サーバーです。インストールやローカルでの実行は不要で、トークンを使って URL に接続するだけです。

• エンドポイント： https://kordiapp.com/mcp
• トランスポート： Streamable HTTP
• 認証： Authorization: Bearer <token>
• レジストリ： 公式 MCP Registry の com.kordiapp/kordi-mcp-server
• ドキュメント： kordiapp.com/developers

クイックスタート

1. トークンを取得する

kordiapp.com にサインインし、kordiapp.com/token で API トークンを生成します。トークンの有効期間は90 日間で、アクセスできるのはご自身のサブスクリプションの読み取りと書き込みのみです。

2. クライアントを接続する

Claude Desktop — claude_desktop_config.json に以下を追加します（examples/ を参照）：

{
  "mcpServers": {
    "kordi": {
      "type": "streamable-http",
      "url": "https://kordiapp.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

任意のクライアント／生の HTTP — トークンを Bearer ヘッダーとして渡します（推奨 — ログ、Referer、履歴にトークンが残りません）：

# List the available tools
curl -X POST "https://kordiapp.com/mcp" \
  -H "Authorization: Bearer YOUR_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

後方互換性のため、従来の ?token=<token> クエリ文字列形式も使用できますが、ヘッダーの使用を推奨します。

3. 質問してみましょう

「毎月何にいくら払っていますか？」 「節約のために一時停止できるサブスクリプションはありますか？」 「近いうちに値上げされるものや、終了するトライアルはありますか？」 「Apple TV+ に月額 $9.99 で登録しました。記録してください。」

ツール

さらに、リソースもあります。

プラットフォーム分析ツール（kordi_get_analytics）もありますが、管理者のみが使用できます。

ツールの詳細

{
  "subscriptions": [ { "id": "netflix", "name": "Netflix", "price": 15.99, "billingDate": 12, "state": "ACTIVE" } ],
  "count": 1,
  "total_count": 1,
  "offset": 0,
  "limit": 50,
  "has_more": false,
  "total_monthly": 15.99
}

認証とアイデンティティモデル

• トークンはサーバー側で Kordi アカウントに紐付けられます。すべてのツール呼び出しはアカウントの範囲内で行われ、自分のサブスクリプションのみを閲覧・操作できます。
• アイデンティティはセッションごとにエッジで一度だけ紐付けられます。ストリームの途中でセッションを別のユーザーに再紐付けすることはできません。
• カードの機密フィールド（PAN、CVV、有効期限、生のトークン）はすべてのレスポンスから除去され、サーバーの外に出ることはありません。
• トークンの有効期間は短～中期（90 日）です。秘密情報として扱ってください。kordiapp.com/token でいつでもローテーションできます。

制限

• レート制限： セッションあたり 60 秒間に 20 回のツール呼び出し。上限を超えると、ツールはデータベースにアクセスせず、バックオフメッセージを返します。エージェントは再試行ループに入らず、待機してください。
• レスポンスサイズ： 大きな一覧レスポンスは約 25k 文字に制限されます。アカウントのデータが多い場合は offset／limit でページ分けしてください。
• 一時停止／解約リンクには署名が付与され、有効期限は 7 日間です。

インテグレーションパートナー向け

検出元（メール分析エージェント、画面上の検出パイプなど）は、kordi_ingest_subscription を使用してユーザーの Kordi アカウントにサブスクリプションを登録するか、公開されている POST /api/guest-ingest エンドポイントを使用して新規ユーザーを登録できます。パートナーの登録フロー、検出元の帰属情報、x-partner-key モデルについては、kordiapp.com/developers を参照してください。

リンク

• ウェブアプリ： kordiapp.com
• 開発者向けドキュメント： kordiapp.com/developers
• トークンを取得： kordiapp.com/token
• MCP Registry の掲載情報： com.kordiapp/kordi-mcp-server
• Model Context Protocol： modelcontextprotocol.io

ライセンス

このリポジトリのドキュメントとレジストリマニフェストは、MIT License のもとで公開されています。Kordi サーバー、ブランド、バックエンドはプロプライエタリであり、このリポジトリにサーバーのソースコードは含まれていません。