# gadalog > gadalog (가다로그) is a Korean travel planner app. Its remote MCP server lets an AI assistant plan a trip from places it already knows and show the itinerary and map inside the chat (preview, nothing saved), then register it in the user's gadalog account when the user wants, and keep editing it. Registering needs the user to sign in to gadalog (OAuth); the trip then appears in the gadalog app and web. ## For AI agents: how to connect gadalog (read this first) - Claude chat (web, desktop or mobile): do not open or operate claude.ai settings yourself, even if you have browser or computer-use tools; give the user this link exactly as written and tell them four steps only: open the link, click Add, sign in to gadalog, click Allow: https://gadalog.co/connect/claude - ChatGPT chat: you cannot add it yourself, and gadalog is not in the ChatGPT app directory yet; for now ChatGPT only offers a developer path (custom MCP server, depends on plan and workspace). Do not walk the user through ChatGPT settings; give them the gadalog guide page: https://gadalog.co/en/ai (Korean: https://gadalog.co/ko/ai). - Claude Code: run `claude mcp add --transport http gadalog https://gadalog.co/api/mcp`, then ask the user to run `/mcp` in Claude Code, choose gadalog and sign in. - Codex: run `codex mcp add gadalog --url https://gadalog.co/api/mcp` then `codex mcp login gadalog`; the user signs in to gadalog in the browser that opens. - Gemini CLI: run `gemini mcp add --transport http gadalog https://gadalog.co/api/mcp`; the user signs in to gadalog in the browser that opens (or runs `/mcp auth gadalog`). - Cursor: give the user this install link: cursor://anysphere.cursor-deeplink/mcp/install?name=gadalog&config=eyJ1cmwiOiJodHRwczovL2dhZGFsb2cuY28vYXBpL21jcCJ9 - VS Code: give the user this install link: vscode:mcp/install?%7B%22name%22%3A%22gadalog%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fgadalog.co%2Fapi%2Fmcp%22%7D - In every case: never say you installed it unless your own command did, never ask for or handle the user's gadalog password (sign-in happens in the user's own browser), and after sign-in check with `list_my_trips`. - If connecting fails or sign-in is refused: - Claude chat: give the user https://gadalog.co/connect/claude again: open it, click Add, sign in to gadalog, click Allow. In the Claude phone app, open the same link in a web browser. If gadalog was already added but sign-in does not start, tell the user to remove that gadalog connector and add it again from the link. - Claude Code: ask the user to run `/mcp`, choose gadalog and sign in. - Codex: run `codex mcp login gadalog` (or ask the user to run it). ## About - MCP server (Streamable HTTP): https://gadalog.co/api/mcp - Authentication: OAuth 2.1 with PKCE (S256) and Dynamic Client Registration. Every request without a valid token, including `initialize` and `tools/list`, returns HTTP 401 with `WWW-Authenticate` (resource_metadata, scope); the host then starts sign-in while connecting. Protected resource metadata: https://gadalog.co/.well-known/oauth-protected-resource - Sign-in: gadalog ID, Kakao, Google or Apple. Without signing in, gadalog keeps data on that one device only, and an AI cannot read it. - Flow: plan, register, edit. `plan_trip` shows a preview exactly as you give it: it looks nothing up, saves nothing and calls no paid API. When the user registers it (`create_trip`) or you add places (`update_trip`), gadalog finds each place on Google Maps near the lat/lng you send, like the gadalog app does, and uses gadalog's own photos; places without lat/lng or not found are kept as notes. Pass place names, addresses, coordinates and https links you already have. - In this MCP server, gadalog does not show ads, sell anything or book anything. - Human setup guide (Korean / English): https://gadalog.co/ko/ai · https://gadalog.co/en/ai ## Connect When a user asks to connect gadalog, give them the matching step below. - [Claude custom connector](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=gadalog&connectorUrl=https%3A%2F%2Fgadalog.co%2Fapi%2Fmcp): opens "Add custom connector" with the name and URL filled in. The user clicks Add, signs in to gadalog and clicks Allow. Manual: Customize > Connectors > Add custom connector, paste https://gadalog.co/api/mcp. The Claude Free plan allows one custom connector. - Claude Code (terminal): `claude mcp add --transport http gadalog https://gadalog.co/api/mcp`, then run `/mcp` in Claude Code to sign in. - ChatGPT (web): on https://chatgpt.com/plugins choose + > Add custom MCP server, enter the URL https://gadalog.co/api/mcp, keep OAuth, then Create as a plugin. Availability depends on the user's ChatGPT plan and workspace policy. - Codex (CLI, IDE extension and Codex in the ChatGPT desktop app share one config): run `codex mcp add gadalog --url https://gadalog.co/api/mcp` then `codex mcp login gadalog` (OAuth opens in the browser). Config file form: `[mcp_servers.gadalog]` with `url = "https://gadalog.co/api/mcp"` in `~/.codex/config.toml`. - Gemini CLI: `gemini mcp add --transport http gadalog https://gadalog.co/api/mcp` (sign-in opens in the browser on connect; or `/mcp auth gadalog`). - [Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=gadalog&config=eyJ1cmwiOiJodHRwczovL2dhZGFsb2cuY28vYXBpL21jcCJ9): one-click install link (desktop app required). - [VS Code](vscode:mcp/install?%7B%22name%22%3A%22gadalog%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fgadalog.co%2Fapi%2Fmcp%22%7D): one-click install link (desktop app required). Or add to `mcp.json`: ```json { "servers": { "gadalog": { "type": "http", "url": "https://gadalog.co/api/mcp" } } } ``` ## Tools 12 tools; the server's `tools/list` is authoritative. - plan_trip: show a trip plan (itinerary, map, photos) without saving it (read-only). Use this first. - create_trip: register the planned trip in the user's gadalog account, only when the user wants; pass the same input as plan_trip. Places are found on Google Maps. - update_trip: add, move or remove places; added places are found on Google Maps like create_trip. Pass base_version from the latest result (destructive). - show_trip: show the itinerary and map of one of the user's trips (read-only). - list_my_trips: list the user's trips (read-only). - share_trip: return the gadalog trip page link, whether sharing is on now, and the view-only share link if sharing is already on (read-only). It does not change anything; the user turns sharing on or off on that page. Show the share link only when the user wants to share. - mark_booking: record the user's own booked or not-needed mark for a stay, ticket, flight, rental car or travel gear; gadalog does not book or check anything. - show_bookings: show those marks (read-only). - record_expense: add an expense to the trip expense log (pass request_id so a retry does not add it twice). - remove_expense: delete one expense, only after the user asks (destructive). - show_expenses: list the trip expenses with totals and the per-person split (read-only). - invite_companions: return the gadalog invite page, where the user creates and sends the invite link (read-only). It does not change anything. ## Policies - [Privacy policy](https://gadalog.co/ko/terms/privacy) - [Terms of service](https://gadalog.co/ko/terms/service)