MAQAMI Travel

MAQAMI トラベル MCP サーバー

MAQAMI 公式 MCP サーバーです。MAQAMI は 300 万件以上のホテルを扱う、ホテルと航空券の予約プラットフォームです。ホテルの最新料金や航空券を検索し、都市、空港、ホテルの詳細を調べたうえで、お客様が選んだ部屋または運賃の予約用セキュアチェックアウトリンクを book.maqami.co でお客様に送信できます。リモート Streamable HTTP エンドポイントで、API キーは不要です。

https://mcp.maqami.co/

クイックスタート

お使いのクライアントを選択してください。各行の設定だけで接続できます。詳しい手順は接続をご覧ください。

クライアント	最速の接続方法
Claude Code	claude mcp add --transport http maqami-travel https://mcp.maqami.co/
Claude Desktop（ワンクリック）	maqami-travel.mcpb をダウンロードして開きます（手順）
任意の stdio クライアント（npm）	サーバーコマンドとして npx -y maqami-travel を使用します（設定）。Node.js 18 以降
claude.ai、Claude Desktop、Claude モバイル	カスタマイズ → コネクタ → カスタムコネクタを追加を選択し、URL https://mcp.maqami.co/ を指定します。サインイン不要。Free プランでも利用できます（手順）
Cursor	Cursor に追加（ワンクリック）、または mcp.json に "maqami-travel": { "url": "https://mcp.maqami.co/" } を追加します
VS Code	VS Code にインストール（ワンクリック）、または code --add-mcp '{"name":"maqami-travel","type":"http","url":"https://mcp.maqami.co/"}' を実行します
Windsurf	mcp_config.json に "maqami-travel": { "serverUrl": "https://mcp.maqami.co/" } を追加します
Gemini CLI	gemini extensions install https://github.com/negm17111995/mcp-server
OpenAI Codex	codex mcp add maqami-travel --url https://mcp.maqami.co/
ChatGPT	開発者モード → URL https://mcp.maqami.co/ のアプリを作成し、認証なしを選択します（手順とプラン）
OpenAI Agents SDK	MCPServerStreamableHttp(name="MAQAMI Travel", params={"url": "https://mcp.maqami.co/"})
LangChain	langchain.mcp の MCPAdapter("https://mcp.maqami.co/") を使用します（例）
n8n	MCP Client Tool ノードを使用し、エンドポイントに https://mcp.maqami.co/ を指定します。HTTP Streamable、認証なし（手順）
Cline	MCP サーバー → リモートサーバーを選択し、URL https://mcp.maqami.co/、Streamable HTTP を指定します
LM Studio	mcp.json に "maqami-travel": { "url": "https://mcp.maqami.co/" } を追加するか、インストールリンクを使用します
予約スキルのみ（Claude Code、Codex、Cursor、その他スキル対応エージェント）	npx skills add negm17111995/mcp-server
その他のクライアント	認証なしの https://mcp.maqami.co/ で Streamable HTTP を使用するか、stdio のみ対応するクライアントでは npx -y maqami-travel を使用します

次のように試してみてください。「リスボンで、5 月 12 日から 15 日まで、大人 2 名で泊まれる 4 つ星ホテルを探してください。」

目次

• 接続
• エージェントによるサーバーの利用方法
• できること
• プロンプトの例
• よくある質問
• 例
• プライバシーとセキュリティ
• 開発

接続

サーバーは https://mcp.maqami.co/ でホストされており、Streamable HTTP トランスポートを使用します。インストールや API キーの設定は不要です。

Claude（claude.ai と Claude Desktop）

MAQAMI をカスタムコネクターとして追加します。

1. カスタマイズ → コネクター に移動します。
2. + 追加 をクリックし、カスタムコネクターを追加 を選択します。
3. 名前に MAQAMI Travel、URL に https://mcp.maqami.co/ を入力し、続行 をクリックします。
4. 認証 で サインインしない を選択し、追加 をクリックします。

Free を含むすべての Claude プランで利用できます。Free アカウントでは、同時に使用できるカスタムコネクターは 1 つです。

Team プランと Enterprise プランでは、先にオーナーが 組織の設定 → コネクター でコネクターを追加します。

Claude Desktop 拡張機能

macOS、Windows、Linux の Claude Desktop にワンクリックでインストールできます。カスタムコネクターの枠を使用しないため、すでにカスタムコネクターを 1 つ使用している Free アカウントにも適しています。

1. maqami-travel.mcpb をダウンロードします。
2. ファイルを開くか、Claude Desktop の 設定 → 拡張機能 にドラッグします。
3. インストール をクリックします。

この拡張機能は npm パッケージと同じ stdio ブリッジを実行し、https://mcp.maqami.co/ に接続します。Claude Desktop には Node.js が含まれているため、ほかにインストールするものはありません。

Claude Code

claude mcp add --transport http maqami-travel https://mcp.maqami.co/

または、サーバーと、検索から確認、チェックアウトリンクの表示まで Claude を案内する予約スキルを追加するプラグインをインストールします。

/plugin marketplace add negm17111995/mcp-server
/plugin install maqami-travel@maqami

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）に追加します。

{
  "mcpServers": {
    "maqami-travel": {
      "url": "https://mcp.maqami.co/"
    }
  }
}

または、ワンクリックでインストールします：Cursor に追加。同じインストールをディープリンクから行う場合は、ブラウザーで次を開きます。

cursor://anysphere.cursor-deeplink/mcp/install?name=maqami-travel&config=eyJ1cmwiOiJodHRwczovL21jcC5tYXFhbWkuY28vIn0=

VS Code

ワークスペースの .vscode/mcp.json に追加します。

{
  "servers": {
    "maqami-travel": {
      "type": "http",
      "url": "https://mcp.maqami.co/"
    }
  }
}

または、VS Code にインストール からワンクリックでインストールするか、コマンドラインからユーザープロファイルに追加します。

code --add-mcp '{"name":"maqami-travel","type":"http","url":"https://mcp.maqami.co/"}'

Cline

Cline パネルで MCP サーバー → リモートサーバー を開き、URL https://mcp.maqami.co/ を入力して、Streamable HTTP を選択します。または、MCP 設定 JSON に追加します。

{
  "mcpServers": {
    "maqami-travel": {
      "type": "streamableHttp",
      "url": "https://mcp.maqami.co/"
    }
  }
}

LM Studio

LM Studio 0.3.17 以降では MCP サーバーを使用できます。右側のサイドバーにある Program タブを開き、Install → Edit mcp.json を選択して、次を追加します。

{
  "mcpServers": {
    "maqami-travel": {
      "url": "https://mcp.maqami.co/"
    }
  }
}

または、ブラウザーで次のリンクを開いてインストールします。

lmstudio://add_mcp?name=maqami-travel&config=eyJ1cmwiOiJodHRwczovL21jcC5tYXFhbWkuY28vIn0%3D

ローカルモデルはコンテキストウィンドウが小さいため、不要なツールを無効にすることを検討してください（FAQ を参照）。

Windsurf

Cascade パネルの … メニューから mcp_config.json（Open MCP config file）を開き、次を追加します。

{
  "mcpServers": {
    "maqami-travel": {
      "serverUrl": "https://mcp.maqami.co/"
    }
  }
}

現行リリースでは、ファイルは ~/.config/devin/mcp_config.json（macOS と Linux）または %APPDATA%\devin\mcp_config.json（Windows）にあります。旧リリースでは ~/.codeium/windsurf/mcp_config.json が使用されます。

ChatGPT

Plus、Pro、Business、Enterprise、Education アカウントでは、ウェブ上で開発者モードのアプリを利用できます。Free プランの ChatGPT に表示されるのは、アプリディレクトリで公開されたアプリのみです。

1. 設定 → セキュリティとログイン を開き、開発者モード をオンにします。
2. プラグイン を開き、+ ボタンを選択して、開発者モードのアプリを作成します。
3. 名前に MAQAMI Travel、URL に https://mcp.maqami.co/ を入力し、認証なし を選択します。
4. 会話で + メニューから 開発者モード を選択し、MAQAMI Travel を選びます。

OpenAI Codex

codex mcp add maqami-travel --url https://mcp.maqami.co/

または、~/.codex/config.toml に追加します。

[mcp_servers.maqami-travel]
url = "https://mcp.maqami.co/"

Gemini CLI

サーバーとそのコンテキストファイルを追加する拡張機能をインストールします。

gemini extensions install https://github.com/negm17111995/mcp-server

または、サーバーのみを追加します。

gemini mcp add --transport http maqami-travel https://mcp.maqami.co/

または、~/.gemini/settings.json に追加します。

{
  "mcpServers": {
    "maqami-travel": {
      "httpUrl": "https://mcp.maqami.co/"
    }
  }
}

OpenAI Agents SDK（Python）

import asyncio

from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp


async def main() -> None:
    async with MCPServerStreamableHttp(
        name="MAQAMI Travel",
        params={"url": "https://mcp.maqami.co/"},
    ) as maqami:
        agent = Agent(name="Travel assistant", mcp_servers=[maqami])
        result = await Runner.run(agent, "Find 4-star hotels in Lisbon for 2 adults, 12 to 15 May.")
        print(result.final_output)


asyncio.run(main())

LangChain（Python）

LangChain 1.x には、langchain.mcp の MCP サポート（ベータ版）が含まれています。pip install langchain langchain-openai でインストールします。

import asyncio

from langchain.agents import create_agent
from langchain.mcp import MCPAdapter


async def main() -> None:
    async with MCPAdapter("https://mcp.maqami.co/") as maqami:
        tools = await maqami.list_tools()
        agent = create_agent("openai:gpt-5.4-mini", tools)
        result = await agent.ainvoke(
            {"messages": [{"role": "user", "content": "Which airports serve Tokyo?"}]}
        )
        print(result["messages"][-1].content)


asyncio.run(main())

事前予約を行う前に承認を求めるバージョンについては、travel-agent-examples/langchain-python をご覧ください。

n8n

1. ワークフローに AI Agent ノードを追加します。
2. Tools の下に MCP Client Tool ノードを追加します。
3. エンドポイントに https://mcp.maqami.co/ を設定し、サーバーのトランスポートには HTTP Streamable（お使いの n8n のバージョンにこのオプションが表示される場合）を、認証には None を選択します。
4. Tools to Include で、ワークフローに必要なツールを選択するか、All のままにします。

その他の Streamable HTTP クライアント

設定	値
URL	https://mcp.maqami.co/
トランスポート	Streamable HTTP
認証	None

ローカル stdio（npm）

stdio サーバーのみをサポートするクライアント向けに、maqami-travel npm パッケージはリモートエンドポイントへのシンプルなブリッジとして機能します。予約処理をローカルで実行することはなく、認証情報も必要ありません。Node.js 18 以降が必要です。

{
  "mcpServers": {
    "maqami-travel": {
      "command": "npx",
      "args": ["-y", "maqami-travel"]
    }
  }
}

これは claude_desktop_config.json や、stdio サーバーを起動するその他のクライアントで動作します。

エージェントによるサーバーの利用方法

このサーバーは標準的な MCP サーバーです。すべてのツールには、入力用の JSON Schema と MCP アノテーションがあり、クライアントは読み取り専用ツール（readOnlyHint: true）と、変更を加えるツールを判別できます。

お客様は必ず MAQAMI のウェブサイト book.maqami.co で予約と支払いを行います。サーバーはホテルまたはフライトを検索し、価格を確保して、その選択内容に対応する checkoutUrl を返します。お客様はそこで宿泊者または搭乗者の詳細を入力し、支払いを済ませて確認を受け取ります。支払いを受け付けたり、支払い情報を尋ねたりするツールはありません。

ホテル予約の流れ

ステップ	内容	ツール（例）
1. 料金を検索	日程と宿泊者に応じた最新の料金です。checkin、checkout、occupancies、currency、guestNationality と、いずれか1つのロケーション項目（countryCode と組み合わせた cityName、latitude と longitude、iataCode、hotelIds、または aiSearch）が必要です。ホテル名で検索するには、hotelName と countryCode を指定して get_data_hotels を呼び出し、その後 hotelIds で検索します。各料金には offerId が付与されます。	post_hotels_rates
2. 詳細を表示	ユーザーが関心を持っているホテルの説明、設備、写真、レビューです。	get_data_hotel、get_data_reviews
3. 確認	ホテル、部屋、日程、宿泊者、料金、キャンセル条件をユーザーに表示し、明確な承諾を待ちます。	（お使いのエージェント）
4. 事前予約	検索結果で返された内容と完全に同じ offerId を1つ確保し、最終料金、キャンセル条件、checkoutUrl を含む prebookId を返します。	post_rates_prebook
5. チェックアウト	宿泊者情報の入力と支払いのため、お客様に checkoutUrl（https://book.maqami.co/booking?prebookId=...）を案内します。	（お使いのエージェント）

フライト予約の流れ

ステップ	内容	ツール（例）
1. 空港を検索	都市を対応する IATA 空港コードに変換します。	get_data_flights_airports
2. フライトを検索	最新のオファーです。origin、destination、date を含む legs、adults、currency が必要です。片道は1区間、往復は2区間です。book.maqami.co で同じ検索を行うための searchUrl も返されます。	post_flights_rates
3. 確認	offerId が引き続き利用可能か確認し、最新の料金、手荷物、運賃規則、そのオファーの checkoutUrl を返します。オファーには有効期限があります（expiration を参照）。利用できなくなっている場合は、再度検索してください。	post_flights_verify
4. 確認	フライト、搭乗者、最終料金、運賃規則をユーザーに表示し、明確な承諾を待ちます。	（お使いのエージェント）
5. チェックアウト	料金は限られた時間だけ確保されるため、お客様に checkoutUrl（https://book.maqami.co/flights/booking?offerId=...）を速やかに案内します。	（お使いのエージェント）

既存の予約

検索、変更、キャンセルの各ツールでは、予約 ID と予約時に使用したメールアドレスが必要です。サーバーは、両方が一致した場合にのみ予約を返したり変更したりします。各予約ツールには bookingId と email の両方を渡してください。顧客のホテル予約を検索するには、予約時に使用したメールアドレスと姓を指定して listBookings を呼び出します。このツールは、予約者のメールアドレスと姓の両方が一致する予約のみを返します。ホテル予約は cancel_hotel_booking でキャンセルし、フライトは post_flights_bookings_bookingid_cancellations でキャンセルします（事前に get_flights_bookings_bookingid_cancellations で返金見積もりを確認してください）。put_bookings_bookingid_amend は、ホテル予約の予約者名、メールアドレス、電話番号を修正します。予約に現在登録されている email と、修正後の holder（firstName、lastName、email、任意の phone）を指定します。

上記のツール名と必須フィールドは、2026 年 10 月にサーバーが公開した内容です。クライアントがサーバーから受け取るツール一覧が常に正しい情報源です。そこに記載されているツールのみが存在し、それ以外のツール名は拒否されます。ホテルの offerId はサーバーによって署名されています。返された値をそのまま渡し、拒否された場合は検索をやり直してください。

エージェントのベストプラクティス

• 不足している情報は推測せず、確認してください。 ホテルの場合は日程、宿泊人数、宿泊者の国籍、通貨を、フライトの場合は日程、搭乗者、通貨を確認します。
• ツールが返した内容だけを提示してください。 価格には通貨を併記し、利用可能な場合はキャンセル規定や運賃規則も示します。
• 読み取り専用ではない操作を行う前に、必ず確認してください。 Prebook は実際の料金を確保し、変更ツールとキャンセルツールは実際の予約を変更またはキャンセルします。まずユーザーに確認し、何が行われるのかを正確に示してください。
• ツールが返すリンクだけを送信してください。 Prebook または verify の checkoutUrl を顧客に案内し、チャットでカード情報やパスポート情報を尋ねないでください。
• **Prebook または verify で価格や空き状況が変わった場合は、**新しい結果を提示して、もう一度確認してください。
• **宿泊者情報は予約に必要なものだけにとどめ、**ユーザーが選択肢を選んだ後にのみ送信してください。
• 応答は簡潔にしてください。 ホテル検索では limit と maxRatesPerHotel を、フライト検索では filters を設定してください。get_data_facilities、get_data_chains、get_data_iatacodes、get_data_cities は参照リスト全体を返すため、ID が必要なときにのみ呼び出してください。空港を検索するには、代わりに get_data_flights_airports を使用してください。

例では、これを実現する方法の一例を示しています。読み取り専用ツールは自動的に実行され、それ以外のツールはすべてユーザーの承認を待ちます。

よくある質問

接続に API キーやアカウントは必要ですか？ いいえ。エンドポイントは認証なしで接続を受け付けます。

顧客はどのように支払いますか？ 支払いは MAQAMI のウェブサイト上でのみ行われます。ホテルを事前予約する場合、またはフライトを確認する場合、checkoutUrl はその部屋または運賃専用の book.maqami.co の URL として返されます。顧客はその URL を開き、宿泊者または搭乗者の情報を入力して安全に支払いを済ませると、そこで予約確認を受け取ります。MCP サーバーが支払いを受け付けることはありません。

チェックアウトリンクを開くと、実際の予約が作成されますか？ はい。顧客が book.maqami.co でチェックアウトを完了すると予約が作成されます。支払いの前に、詳細と最終価格をご確認ください。

サーバーはどのトランスポートを使用しますか？ https://mcp.maqami.co/ の Streamable HTTP です。クライアントが stdio のみをサポートする場合は、maqami-travel npm bridge を使用してください。

クライアントにツールが多すぎるという警告が表示されます。どうすればよいですか？ 必要なツールだけを有効にしてください。ほとんどのクライアントで設定できます。VS Code のツールピッカー、Cursor と Claude のツールごとの切り替え、n8n の Tools to Include などを利用できます。旅行アシスタントには、上の表にある検索、詳細、事前予約、確認のツールがよい出発点です。

サーバーには何が見えますか？ MCP サーバーが受け取るのは、クライアントが送信するツール呼び出しと引数だけです。会話の残りの部分は見えません。

サーバーはどこに掲載されていますか？ 公式 MCP Registry では io.github.negm17111995/maqami-travel として、npm では maqami-travel として掲載されています。また、Claude Desktop 拡張機能（maqami-travel.mcpb）でもあります。このリポジトリは、Gemini CLI 拡張機能（gemini-extension.json）、Claude Code プラグインおよびマーケットプレイス（.claude-plugin/）、Codex プラグイン（.codex-plugin/plugin.json）、Agent Plugins パッケージ（plugin.json および mcp.json）でもあります。プラグインには maqami-travel-booking スキルが同梱されています。掲載ディレクトリ： Smithery、Glama、Raycast の MCP Registry、ToolSDK MCP Registry、Hermes Agent プラグインカタログ。

自分のエージェントや製品で使用できますか？ はい。公開エンドポイントです。上記の予約確認に関するガイダンスに従ってください。パートナーシップについては、[email protected] までお問い合わせください。

バグやセキュリティ上の問題を報告するにはどうすればよいですか？ バグやクライアントのセットアップに関する問題は、issue を作成してください。セキュリティ上の問題については、SECURITY.md の手順に従い、公開 issue は作成しないでください。

使用例

negm17111995/travel-agent-examples には、OpenAI Agents SDK（Python）、LangGraph を使用した LangChain（Python）、Vercel AI SDK（TypeScript）からこのサーバーに接続する、小規模で実行可能な旅行アシスタントの例があります。いずれも、読み取り専用ではない呼び出しを行う前に、ユーザーの承認を求めます。

できること

• ライブ料金と空室状況を確認しながら、ホテルを検索できます。
• フライトを検索して運賃を比較できます。
• 都市、空港、ホテルの詳細を検索できます。アメニティや写真も確認できます。
• ホテルの部屋の料金を確保（事前予約）したり、フライトの運賃を確認したりできます。
• 顧客が book.maqami.co で詳細を入力して支払い、予約確認を受け取るためのチェックアウトリンクを送信できます。
• 既存の予約を検索、確認、キャンセルできます。メールアドレスと姓で予約を検索し、予約 ID とメールアドレスを使って操作します。

プロンプトの例

• 「8 月 15 日から 17 日まで、イスタンブールで大人 2 名向けの 5 つ星ホテルを探してください。」
• 「2 番目のホテルのアメニティと写真を見せてください。」
• 「12 月 10 日に、ドバイからロンドンまで、大人 1 名のフライトを検索してください。」
• 「東京にはどの空港がありますか？」
• 「その部屋を確保して、チェックアウトリンクを送ってください。」

プライバシーとセキュリティ

• 接続に API キーやアカウントは必要ありません。
• https://mcp.maqami.co/ へのすべての通信は HTTPS で暗号化されます。
• 検索と予約は MAQAMI によって処理されます。支払いは book.maqami.co でのみ行われ、MCP サーバーがカード情報を受け取ることはありません。
• チェックアウトを完了すると、実際の予約が確定します。支払いの前に、詳細と最終価格をご確認ください。
• プライバシーポリシー：maqami.co/privacy-policy

開発

このリポジトリには npm の stdio ブリッジ（index.js）が含まれています。ホスト型サーバーは別途デプロイされます。

npm install
npm test

ブリッジのテストでは、ローカルのモック Streamable HTTP サーバーを起動し、MAQAMI_MCP_URL 環境変数を使ってブリッジの接続先に指定します。この変数はテスト専用です。デフォルトでは、ブリッジは https://mcp.maqami.co/ に接続します。マニフェストのテストでは、すべてのマニフェストが解析できること、同じエンドポイントを指していること、package.json のバージョンを含んでいることを確認します。

リポジトリの構成

ファイル	用途
index.js	ホスト型エンドポイントへの npm stdio ブリッジ
server.json	公式 MCP Registry エントリ
gemini-extension.json, GEMINI.md	Gemini CLI 拡張機能とそのコンテキストファイル
.claude-plugin/plugin.json, .mcp.json	Claude Code プラグイン
.claude-plugin/marketplace.json	Claude Code プラグインマーケットプレイス（maqami）
.codex-plugin/plugin.json, assets/logo-512.png	Codex プラグインとそのアイコン
plugin.json, mcp.json	Agent Plugins マニフェスト
mcpb/manifest.json, scripts/build-mcpb.sh	Claude Desktop 拡張機能（npm run build:mcpb を実行すると dist/maqami-travel.mcpb が作成されます）
skills/maqami-travel-booking/SKILL.md	プラグインにバンドルされている予約スキル
glama.json	Glama ディレクトリのメタデータ
AGENTS.md, llms.txt	コーディングエージェントと LLM ツール向けの簡易ガイド
test/	ローカルのモックサーバーに対するブリッジテストと、マニフェストの整合性チェック（npm test）
.github/workflows/	CI（すべてのプルリクエストで npm test を実行）と、npm および Official MCP Registry に公開するリリースワークフロー

コントリビューション

ドキュメントの修正、クライアントのセットアップガイド、バグ報告を歓迎します。CONTRIBUTING.md と 行動規範 をご覧ください。質問やアイデアは ディスカッション までお寄せください。

ライセンス

MIT

サポート

質問や問題については、[email protected] または課題を作成してください。

MAQAMI について

MAQAMI（MAQAMI LLC）は米国で登録された旅行会社で、世界中のホテルと航空券を販売しています。300 万件を超える宿泊施設、即時予約確定、安全な Stripe チェックアウト、24 時間年中無休のサポートを提供しています。

• ウェブサイト： maqami.co
• ホテルと航空券の予約： book.maqami.co
• この MCP サーバー（セットアップガイド）： maqami.co/mcp