Voyagier

@voyagier/cli

ターミナルから実際の旅行を計画し、料金を確認して予約できます。すべての情報は voyagier.com と同期されます。

この CLI は Voyagier MCP サーバーを操作するシェルです。ツールごとに 1 つのコマンドを実行します。 旅行計画の各コマンドは 1 つの MCP ツールです — voyagier <tool_name> --<param> <value> — サーバーのツール一覧（https://mcp.voyagier.com/api/mcp）に基づいて実行時に構築されます。同じツールが claude.ai、Claude Desktop、その他すべての MCP クライアントで使われるため、各動詞の実装は 1 つだけで済み、サーバーに公開されたツールはアップグレードなしでターミナルにも表示されます。stdio のみをサポートするホスト向けに、voyagier mcp は同じサーバーへのプロキシとして機能します。

npm install -g voyagier             # or the canonical package: @voyagier/cli
voyagier auth login                 # browser flow; keeps the token out of shell history
voyagier doctor                     # credentials, MCP connection, tool count, version
voyagier mcp install claude-code    # point an MCP client at the hosted server (also: cursor, claude-desktop)
voyagier update                     # later: bring a global install to the latest release

voyagier は、互換性のある最新の @voyagier/cli リリースを追跡する便利なエイリアスです。特定のバージョンに固定する場合は、正式なパッケージを使用してください：npm install -g @voyagier/cli@<version>。

インストール権限がない場合（サンドボックス化されたエージェント、CI など）でも、すべてのコマンドを npx でインストールせずに実行できます：

VOYAGIER_TOKEN=<your-token> npx @voyagier/cli doctor --json

クイックスタート

旅行プランは目標グラフです。プランには目標（フライト、ホテル、日程、目的地、旅行者）が含まれており、在庫を調べ、検索結果を目標に反映し、オプションを選択して旅行を組み立てます。検索は非同期です — ステータスが終端状態になるまでポーリングしてください。

# 1) Find or create the client
voyagier list_clients --query "Doe" --json
voyagier create_client --name "Doe Family" --client_type Individual --email "[email protected]" --json

# 2) Resolve the destination, then scaffold the plan with its party
voyagier search_destinations --query "Lisbon" --json
voyagier create_plan --client_id <CLIENT_ID> --title "Doe — Lisbon" \
  --travel_destination_id <DESTINATION_ID> --start_date 2026-11-20 --end_date 2026-11-27 \
  --travellers '[{"first_name":"Jane","last_name":"Doe","type":"Adult"}]' --json

# 3) Explore flights (no plan is touched), poll, then promote the result onto the plan's goal
voyagier search_flights --from BWI --to LIS --date 2026-11-20 --return 2026-11-27
voyagier get_search_status --search_id <SEARCH_ID>
voyagier promote_search --plan_id <PLAN_ID> --search_id <SEARCH_ID> --goal_id <GOAL_ID> --json

# 4) Options → pick
voyagier get_options --selection_id <SELECTION_ID>
voyagier select_option --option_id <OPTION_ID> --json

# 5) Readiness, quote, book at exactly the quoted price
voyagier get_plan_status --plan_id <PLAN_ID>
voyagier get_plan_quote --plan_id <PLAN_ID>
voyagier book_plan --plan_id <PLAN_ID> --expect_total_cents <CENTS> --item_ids <ID> <ID> --json

# Not sure which tool? Ask the server.
voyagier search_tools --query "hotel dates" --json
voyagier get_tool_details --name set_hotel_dates --json

voyagier <tool_name> --help を実行すると、サーバーによるツールの説明と、入力ごとのフラグ（型と必須かどうかを含む）が表示されます。

コマンドの仕組み

• voyagier --help には、ローカルコマンドと、サーバーが公開するツールごとのコマンドが一覧表示されます。
• フラグはツールの入力スキーマに対応しています。 plan_id は --plan_id です。必須の入力には必須フラグが必要です。文字列、整数、数値、ブール値（--force ／ --force false）、列挙型（許可される値は --help に表示）、配列（--item_ids a b、またはフラグを繰り返し指定）、オブジェクトの JSON リテラル（--travellers '[…]'。--help にはオブジェクトのキーが型と説明とともに表示され、必須のキーにはアスタリスクが付きます）が使用できます。スキーマで null が許可されているフラグ（--help で (pass null to clear) と表示）には、リテラルの null も指定でき、JSON null として送信されます。voyagier update_plan --plan_id <id> --cover_media_id null を実行すると、カバー写真がクリアされます。繰り返し指定できる配列フラグにはすべて --no-<flag> の形式のフラグが用意されており、空のリスト [] を送信します。これは、ツールで定義されている場合に、サーバー独自の「空のリストを渡してクリアする」動作を行います。voyagier get_search_status --search_id <id> --no-airlines を実行すると、航空会社フィルターをクリアした状態で保存済みの検索結果を取得できます。ツール自身のスキーマ内のローカルな $ref として記述されたプロパティまたは項目のスキーマは、フラグの型が決まる前に解決されるため、参照先と同様に扱われます。
• 出力。 --json を指定すると、ツールの結果が JSON として出力されます。ラッパーキーのない、ペイロードオブジェクトそのものです。指定しない場合、get_plan_status、search_flights ／ search_hotels ／ search_activities ／ get_search_status ／ promote_search、get_options、get_plan_itinerary、get_plan_quote は簡潔で読みやすい形式で表示されます。それ以外のすべてのツール（search_destinations、search_tools、refresh_options など）は、JSON を整形して出力します。
• エラー はすべて共通の形式で出力されます。{ "error": true, "code", "message", "details"? } で、終了コードは 1 です。AUTH_FAILED、PERMISSION_DENIED、RATE_LIMITED（details.retryAfterSeconds を含む）、VALIDATION、API_ERROR（ツール独自のエラーテキスト）、NETWORK、COMMAND_REMOVED があります。
• ツールキャッシュ。 サーバーのツール一覧は ~/.voyagier/tools-cache.json に24時間キャッシュされます。voyagier doctor を実行するとキャッシュが更新されます。また、キャッシュに未登録のツール名を実行した場合も更新されます。doctor と --verbose は、ツールのサーフェス（名前と入力スキーマ）の安定したハッシュを出力するため、スクリプトから契約の変更を検出できます。
• エージェントの実行基盤。 非対話型です。--json の場合、標準出力には JSON ドキュメントが1つだけ出力されます（診断情報、スピナー、警告は標準エラー出力に送られます）。終了コードは安定しており（0 ／ 処理済みのエラーは1 ／ 予期しないエラーは2）、表示される出力には絶対時刻が使われます。

コマンド

コマンド	説明
voyagier <tool_name>	MCP ツールごとに1つのコマンドが用意されています。たとえば、list_plans、search_destinations、create_plan、search_flights、promote_search、get_options、select_option、get_plan_status、get_plan_quote、book_plan があります。サーバーが現在提供しているコマンドは voyagier --help に一覧表示されます。CLI 内から search_tools と get_tool_details を使って、ツールを検索したり説明を確認したりできます
voyagier doctor	自己診断：認証情報、MCP サーバーへの接続とツール一覧、ID、状態、バージョン
voyagier update	グローバルにインストールされた npm パッケージを最新リリースに更新します（別名は upgrade。インストールせずに確認する場合は --check、スクリプトから実行する場合は --json を指定します）
voyagier auth	Personal Access Token を管理します（login、set-token、status、logout、setup）
voyagier mcp install <client>	MCP クライアント（Claude Code、Cursor、Claude Desktop）を Voyagier MCP サーバーに接続します
voyagier mcp	ホスト型 Voyagier MCP サーバーへのプロキシとなる stdio MCP サーバーを実行します
voyagier agent-docs	サーバーのエージェント向けガイダンスに続けて、CLI の使用上の注意（AGENT.md）を表示します
voyagier telemetry	匿名の利用状況テレメトリーを管理します（status、on、off）

3.x の旅行計画コマンド（plan-trip、search flights、select、plans …、clients … など）はすべてツールに置き換えられています。これらのコマンドを実行すると、代替のツールが表示され、終了コード1で終了します。全コマンドの表は CHANGELOG をご覧ください。

AI エージェント向け

voyagier agent-docs            # the MCP server's guidance, then the CLI usage notes (AGENT.md)
npx @voyagier/cli agent-docs   # zero-install variant

最初の部分はサーバー独自の instructions（旅行計画のガイダンス：ツールの順序、検索の完了方法、予約の制限方法）で、すべての MCP クライアントが受け取る同じテキストです。2つ目の部分は AGENT.md で、ツールモデル、フラグの型、JSON の形式、エラーコード表、3.x への移行について説明しています。

AI エージェントを接続する

Voyagier は https://mcp.voyagier.com/api/mcp でホスト型 MCP サーバーを提供しています。これは、AI エージェントやアシスタントが Voyagier を利用するための推奨方法です。クライアントは Personal Access Token を使って HTTP 経由で接続し、管理が必要なローカルインストールなしで、すべてのツールを利用できます。CLI も同じツールを提供しており、コマンドラインのワークフロー、スクリプト、CI で利用できます。

voyagier mcp install <client> を実行すると、1ステップで設定できます。

voyagier mcp install claude-code      # writes ./.mcp.json (--global writes ~/.claude.json)
voyagier mcp install cursor           # writes ~/.cursor/mcp.json (--project writes ./.cursor/mcp.json)
voyagier mcp install claude-desktop   # writes claude_desktop_config.json

保存済みのトークン（voyagier login）を使い、クライアントの既存の設定に voyagier エントリを追加します。このファイル内のほかのすべてのサーバーには影響しません。--dry-run を渡すと、書き込み前に解決されたパスと正確なエントリを確認できます。また、--token <pat> を渡すと、特定のトークンをインストールできます。すべての出力でトークンはマスクされ、設定ファイルにのみ書き込まれます。変更を反映するには、その後クライアントを再起動してください。

Claude Desktop の設定形式は stdio サーバーのみを記述するため、このクライアントは CLI のローカルサーバー（voyagier mcp）に接続します。アプリの設定にあるリモートコネクターのセクションから Voyagier を追加することもできます。この方法では、ホスト型エンドポイントに直接接続します。

Stdio MCP プロキシ

stdio のみをサポートするホスト向けに、CLI にはホスト型サーバーのプロキシとして動作する MCP stdio サーバーが含まれています。

voyagier mcp          # stdio proxy (JSON-RPC on stdout)

独自のツールテーブルはありません。tools/list と tools/call は https://mcp.voyagier.com/api/mcp（または VOYAGIER_MCP_URL）に転送され、VOYAGIER_TOKEN または保存済みの認証情報のトークンが使われます。結果はサーバーから受け取ったとおりに返されるため、プロキシでは常にサーバーの最新のツールが公開されます。サーバーの instructions は initialize の際にそのまま渡されます。サーバーに接続できない場合も、プロキシはローカルのハンドシェイクを完了し、問題を instructions で説明します。その後の各リクエストは、修正方法（401 の場合は VOYAGIER_TOKEN を設定、429 の場合は Retry-After の時間だけ待機）を示す JSON-RPC エラーを返し、サーバーへの再試行を続けます。そのため、環境を修正するために再起動する必要はありません。クライアントがリモート MCP サーバーをサポートしている場合は、ホスト型エンドポイントへの直接接続を推奨します。

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "voyagier": {
      "command": "npx",
      "args": ["-y", "@voyagier/cli", "mcp"],
      "env": { "VOYAGIER_TOKEN": "voy_pat_xxxxx" }
    }
  }
}

環境変数

変数	説明
VOYAGIER_TOKEN	Personal Access Token（保存済みのトークンを上書きします）
VOYAGIER_MCP_URL	すべてのツールコマンド、stdio プロキシ、拡張機能が呼び出す MCP エンドポイント（デフォルト：https://mcp.voyagier.com/api/mcp）。https:// が必要です。ローカル開発時に限り、localhost／127.0.0.1／::1 では通常の http:// も使用できます
VOYAGIER_API_URL	voyagier auth setup によるプロファイル更新で使用する GraphQL ベース URL（デフォルト：https://travel.voyagier.com/api）。VOYAGIER_TOKEN と併せて指定した場合に有効です
VOYAGIER_CONFIG_DIR	認証情報とツールキャッシュの保存ディレクトリ（デフォルト：~/.voyagier）

仕組み

CLI は MCP クライアントです。起動時にサーバーの tools/list を読み込み（キャッシュが最新の場合はローカルキャッシュから読み込み）、各ツールの JSON 入力スキーマから生成したフラグを使って、ツールごとに 1 つの Commander コマンドを登録します。コマンドを実行すると、トークンを Bearer ヘッダーとして付けて Streamable HTTP 経由で tools/call を送信し、サーバーのセッションヘッダーとレート制限ヘッダーに従って結果を出力します。操作の順序、検索の完了方法、予約の制御方法はサーバーのルールに従います。voyagier agent-docs と各ツールの --help を確認してください。

レート制限。 ホスト型エンドポイントでは、トークンごとに 1 分あたり 180 リクエストまで許可されます。この数には、CLI、stdio プロキシ、同じトークンを使うその他すべてのクライアントからのリクエストが含まれます。スクリプトでループを実行する場合は、バックオフしてください。サーバーから Retry-After が送信されると、CLI は details.retryAfterSeconds を含む RATE_LIMITED を報告します。

アクセスの取得

Voyagier のアクセスは申請制であり、誰でも登録できるわけではありません。アドバイザー、旅行プランナーの顧客、エージェントの開発者を問わず、voyagier.com/agents からアクセスを申請してください。

アカウントに API アクセスが付与されたら、travel.voyagier.com/me/settings/tokens で個人アクセストークンを発行すれば利用を開始できます。現在、CLI では 2 種類のアカウント階層を利用できます。

• 旅行アドバイザー — 顧客の一覧を管理します（list_clients、create_client）。プランは顧客に対して作成します（create_plan --client_id <CLIENT_ID>）。
• 旅行プランナー — 自身の旅行を計画する顧客です。--client_id を省略すると、create_plan は自分の顧客レコード（list_clients が返す isSelf: true のエントリ）に自動的にプランを登録します。

管理者以外のトークンには有効期限があります（最長 90 日、デフォルトは 30 日）。期限が切れたら、新しいトークンを発行してください。

ヒント： voyagier auth set-token <token> よりも、対話型プロンプトを使う voyagier login をおすすめします。シェルの履歴にトークンが残りません。スクリプトでは、標準入力経由でトークンを渡す（echo "$VOYAGIER_PAT" | voyagier auth set-token -）か、VOYAGIER_TOKEN 環境変数を使用してください。

Claude Desktop 拡張機能（MCPB）

stdio プロキシは、Claude Desktop 拡張機能バンドル（MCPB）としてもパッケージ化されています。この拡張機能は、インストール時に入力した Personal Access Token を使って Claude Desktop をホスト型 Voyagier MCP サーバーに接続し、サーバーの最新のツールを常に公開します。リポジトリから scripts/build-mcpb.sh を実行してビルドすると、dist-mcpb/voyagier-<version>.mcpb が生成されます。インストールするには、.mcpb ファイルを Claude Desktop → Settings → Extensions にドラッグし、プロンプトが表示されたらトークンを入力してください。

プライバシーポリシー

CLI および Voyagier サービスを通じて処理されるデータは、Voyagier プライバシーポリシーに従って取り扱われます。

ライセンス

Apache-2.0 — Copyright 2026 Voyagier, Inc. CLI を通じた Voyagier サービスの利用には、Voyagier 利用規約が適用されます。「Voyagier」と Voyagier のロゴは Voyagier, Inc. の商標です。Apache-2.0 ライセンスは商標権を付与するものではありません。