Kourier

Kourier MCP サーバー

Kourier のリモート Model Context Protocol (MCP) サーバーです。コーディングエージェント向けの定額制ホスト型 AI 推論を提供します。

MCP サーバーを使って、プランの確認、モデルの上限の確認、コーディングクライアントの設定、人間の承認を得たサブスクリプション登録の開始、アカウントに関連付けられたフィードバックやエラーレポートの送信ができます。Kourier は OpenAI 互換および Anthropic 互換の推論 API を通じて DeepSeek V4.1 Flash を提供し、トークンごとの課金やリクエスト数の割り当てはありません。プランは同時実行数が異なります。

https://kourier.sh/mcp

トランスポート： Streamable HTTP、ステートレス、JSON レスポンス。認証： 情報の取得や登録手続きには必要ありません。submit_feedback には、接続の Authorization: Bearer ヘッダーに Kourier API キーが必要です。

MCP が提供するのはサービス情報とセットアップ手順であり、モデル推論ではありません。推論には、サブスクリプション API キーを https://api.kourier.sh/v1（OpenAI 互換）または https://api.kourier.sh/anthropic（Anthropic 互換）で使用します。

このリポジトリではホスト型サービスについて説明しています。インストールまたは実行するローカルサーバーはありません。稼働中の MCP サーバーは、読み取り専用の情報ツール 4 つ、登録手続き用ツール 3 つ、認証が必要なフィードバックツール 1 つの、計 8 つのツールを提供します。継続課金とエージェントのアクセスには、専用の推論キーが発行される前に、ブラウザー上で人間による明示的な承認が必要です。

クイックスタート

Claude Code

claude mcp add --transport http kourier https://kourier.sh/mcp

Cursor / mcpServers を使用するクライアント

次の項目をクライアントの MCP 設定に追加します。

{
  "mcpServers": {
    "kourier": {
      "url": "https://kourier.sh/mcp"
    }
  }
}

設定形式はクライアントによって異なります。クライアントからサーバー URL を求められたら、上記のリモート Streamable HTTP URL を使用してください。

接続したら、次のように尋ねてください。「Kourier のプランと、コーディングクライアントでの設定方法を教えてください。」

この MCP サーバーを追加しても、コーディングクライアントを動かすモデルは変更されません。get_setup_instructions を使用して、推論プロバイダーとして Kourier を別途設定してください。

ツール

MCP への接続、および情報ツールやオンボーディングツールの使用に、接続認証情報は必要ありません。オンボーディングの状態確認と完了には、create_checkout_link が返す非公開の onboarding_token が必要です。submit_feedback のみ、API キーを含むベアラーヘッダーが必要です。トークンやキーをログ、公開メッセージ、レポートの内容、リポジトリに含めないでください。

ツール	引数	機能
get_pricing	なし	公開プラン、月額料金、同時実行数の上限、使用量上限に関する情報を返します。
get_models	なし	提供されるモデルの正確な API 識別子、およびコンテキストと出力の上限を返します。
get_api_key_instructions	なし	ダッシュボードへのサインアップ、エージェントのサインイン、PKCE を使った OAuth について説明します。API キー自体は返しません。
get_setup_instructions	harness は省略可能	oh-my-pi、claude-code、codex、または openai-compatible の設定方法を返します。汎用の OpenAI 互換設定を使用する場合は、引数を省略してください。
create_checkout_link	plan、client_name。harness は省略可能	本人確認済みのサインイン、Starter／Pro の定期購入、明示的なエージェントアクセスの承認を開始します。ブラウザーリンクと承認コードを返します。リンクの作成だけでは課金もキーの発行も行われません。
get_onboarding_status	非公開の onboarding_token	承認と利用資格の状態を確認します。5 秒ごとにポーリングし、準備完了の場合にのみ完了処理を行ってください。発行済み、拒否、または期限切れの場合は停止してください。
complete_onboarding	非公開の onboarding_token	準備完了状態のオンボーディングを、一度だけ専用の取り消し可能な推論キーに交換します。安全に保存してください。発行後や配信状況が不明な場合は再試行せず、代わりに状態を確認してください。
submit_feedback	kind、message。request_id、client_name は省略可能	アカウントに紐付けたフィードバックまたはエラーレポートを保存します。接続の Authorization: Bearer ヘッダーに Kourier API キーが必要です。ツールの引数には含めないでください。

たとえば、get_setup_instructions を次のように呼び出します。

{
  "harness": "claude-code"
}

サーバーは kourier-setup Markdown リソースと configure_kourier プロンプトも公開しています。このプロンプトは、同じ省略可能な harness 値を受け取ります。

フィードバックとエラーレポート

製品へのフィードバックの送信や Kourier のエラー報告には、submit_feedback を使用してください。レポートは API キーを所有するアカウントに紐付けられます。

認証とプライバシー

• MCP 接続に Authorization: Bearer <your Kourier API key> を設定してください。キーはクライアントの非公開の認証情報設定に保存し、実際のキーをリポジトリの設定に追加しないでください。
• キーは有効で、期限切れでも取り消し済みでもない必要があります。また、アカウントが利用停止されていない必要があります。有効なキーがあれば、問題の報告に推論サブスクリプションは必要ありません。
• 公開情報ツールとオンボーディングツールは、このヘッダーがなくても引き続き利用できます。カスタムヘッダーに対応していないクライアントでもこれらのツールは動作しますが、フィードバックの送信にはヘッダーに対応したクライアントが必要です。
• ユーザーが共有を希望する情報のみを送信してください。API キー、オンボーディングトークン、パスワード、個人データ、非公開のコードやログは除外してください。サニタイズ済みの Kourier リクエスト ID は、エラーの調査に役立ちます。

引数

引数	必須	値
kind	はい	製品へのフィードバックには feedback、エラーレポートには error を指定します。
message	はい	空白のみではないテキストを、トリミング後に 1～8,000 文字で指定します。エラーの場合は、非公開情報を含めずに、期待される動作、実際の動作、再現手順を説明してください。
request_id	いいえ	エラーに関連する Kourier リクエスト ID を、トリミング後に 1～200 文字で指定します。
client_name	いいえ	クライアントまたはハーネスの名前とバージョンを、トリミング後に 1～80 文字で指定します。

NUL バイト、指定された空白のみの文字列、追加フィールド、認証情報を含む引数は受け付けられません。

例

有効なキーを指定して次のコマンドを実行すると、フィードバックレポートが保存されます。サンプルメッセージをユーザーが承認したフィードバックに置き換え、実行前に環境内で KOURIER_API_KEY を非公開で設定してください。

curl https://kourier.sh/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer $KOURIER_API_KEY" \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "submit_feedback",
      "arguments": {
        "kind": "feedback",
        "message": "Please add more coding-client setup examples to the documentation.",
        "client_name": "curl"
      }
    }
  }'

送信に成功すると、result.structuredContent に id と created_at を含む受領情報が返されます。同じ受領情報は result.content に JSON テキストとしても含まれます。ツールが失敗すると、result.isError が true に設定され、error と error_description が返されます。

• unauthorized — 有効な Kourier API キーのベアラーヘッダーを設定してください。
• invalid_arguments — 送信したフィールドと、上記の制限を修正してください。
• rate_limited — 再送信する前に、retry_after に示された秒数だけ待ってください。
• service_unavailable — 受領情報を確認できませんでした。レポートはすでに保存されている可能性があります。再送信すると重複が発生する可能性があるため、むやみに再試行しないでください。

ホステッド推論

プラン

プラン	月額料金（USD）	同時リクエスト数
Starter	$20	1
Pro	$50	3

どちらの公開プランにも、5時間、週単位、月単位のリクエスト数またはトークン数の上限はありません。リクエストが完了すると、同時実行枠が再び利用可能になります。「利用量の上限なし」は、同時リクエスト数が無制限という意味ではありません。

現在の条件については、get_pricing または料金ページを確認してください。MCP エンドポイントが受け付けるのは JSON-RPC POST リクエストであり、通常のブラウザー GET リクエストではありません。

モデルとエンドポイント

設定	値
モデル	DeepSeek V4.1 Flash
正確な API モデル識別子	deepseek-v4.1-flash
OpenAI 互換のベース URL	https://api.kourier.sh/v1
Anthropic 互換のベース URL	https://api.kourier.sh/anthropic
プロンプトと出力を合わせた最大コンテキスト	262,144 トークン（256K）
応答あたりの最大出力	16,384 トークン
認証	Authorization: Bearer <key>。Anthropic のインターフェースでは x-api-key も利用できます

正確なモデル識別子を使用してください。エイリアスはサポートされていません。現在の利用可否と制限については、get_models とモデルのドキュメントを確認してください。

接続する

1. アカウントを作成します。
2. Billing で Starter または Pro を選択します。
3. Dashboard → API Keys で API キーを作成します。
4. get_setup_instructions を呼び出してクライアントを指定し、返された設定を適用します。

エージェントを利用したサインインについては、Kourier の auth.md とエージェントのサインインガイドに従ってください。ブラウザーで人による承認が必要です。公開 MCP サーバーに接続しただけでは、課金の承認や推論へのアクセス権の付与は行われません。

API キーは環境変数またはクライアントの非公開の認証情報ストアに保管してください。リポジトリにコミットしたり、公開イシューに貼り付けたりしないでください。公開情報ツールには推論用のキーは必要ありません。

curl による推論リクエスト

有効なサブスクリプションがあり、環境内に KOURIER_API_KEY が設定されている場合：

curl https://api.kourier.sh/v1/chat/completions \
  -H "Authorization: Bearer $KOURIER_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "Explain what this coding API supports."}],
    "max_tokens": 256
  }'

MCP 接続を確認する

API キーなしで初期化リクエストを送信します。

curl https://kourier.sh/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-11-25",
      "capabilities": {},
      "clientInfo": {"name": "kourier-quickstart", "version": "1.0.0"}
    }
  }'

応答には、サーバーが kourier-info であることと、ツール、リソース、プロンプトが示されます。サポートされているプロトコルのバージョンは 2025-11-25、2025-06-18、2025-03-26 です。

利用可能なツールを一覧表示します。

curl https://kourier.sh/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  --data '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

このエンドポイントは永続的な SSE ストリームや MCP セッションを提供しません。GET と DELETE は 405 を返します。JSON-RPC の POST を使用してください。通常、MCP クライアントがプロトコルの初期化を自動的に処理します。

リンク

ホスト型サービスは、公式 MCP Registry に sh.kourier/info として公開されています。このリポジトリには、レジストリのメタデータ用の server.json、メンテナーの確認用の glama.json、LobeHub への公開用の lhm.plugin.json が含まれています。ディレクトリでのアカウント確認と審査は、レジストリへの公開とは別に行われます。

• ウェブサイト： kourier.sh
• 料金： kourier.sh/pricing
• ダッシュボード： app.kourier.sh
• ドキュメント： docs.kourier.sh/docs
• エージェントのサインイン： kourier.sh/auth.md
• MCP サーバーカード： kourier.sh/.well-known/mcp/server-card.json
• セットアップスキル： kourier-setup/SKILL.md

ドキュメントの修正については、このリポジトリでイシューを作成してください。アカウントや請求に関するサポートについては、Kourier のウェブサイトまたはダッシュボードにあるサポート窓口をご利用ください。ここではアカウントの認証情報を開示しないでください。