# How to connect Jinko to Claude ```json { "title": "How to connect Jinko to Claude", "toolkit": "Jinko", "toolkit_slug": "jinko", "framework": "Claude Cowork", "framework_slug": "claude-cowork", "url": "https://composio.dev/toolkits/jinko/framework/claude-cowork", "markdown_url": "https://composio.dev/toolkits/jinko/framework/claude-cowork.md", "updated_at": "2026-10-04T16:04:22.345Z" } ``` ## Introduction Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf. This guide walks you through the easiest and most secure way to connect your Jinko account to Claude via Composio Connect, enabling it to find cheapest roundtrip flights to Tokyo, book a refundable hotel in Paris, add baggage and seat selection to booking, and more such actions on your behalf without compromising your account security. Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three. ## Also integrate Jinko with - [ChatGPT](https://composio.dev/toolkits/jinko/framework/chatgpt) - [Hermes](https://composio.dev/toolkits/jinko/framework/hermes-agent) - [Atomic Agent](https://composio.dev/toolkits/jinko/framework/atomic-agent) ## Connect Jinko to Claude Cowork ### Connecting Jinko to Claude Web, Desktop, and Cowork Two ways to add the Composio connector. Pick whichever you prefer. ### 1. Add with one click Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2. [Add to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Composio&connectorUrl=https%3A%2F%2Fconnect.composio.dev%2Fmcp) ### Add manually In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top. Click Add custom connector and paste in the Composio MCP server URL: ```bash https://connect.composio.dev/mcp ``` ## What is the Jinko MCP server, and what's possible with it? The Jinko MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Jinko account. It provides structured and secure access to flight and hotel discovery, trip planning, travel extras, and hosted checkout, so your agent can search travel options, build trips, manage travelers, select ancillaries, and prepare checkout on your behalf. - Flight and destination discovery: Have your agent find destinations within your budget, compare fares across flexible dates, and search live flight offers for specific routes. - Hotel search and research: Let the agent search available hotels and room rates, then review property details, policies, facilities, images, and room information. - Trip creation and updates: Direct your agent to create a trip, review its current details, add or remove flight and hotel options, and keep the itinerary up to date. - Traveler details and ancillaries: Instruct your agent to update travelers and booking contacts, browse available baggage, seat, meal, and other extras, and change selected ancillaries. - Hosted travel checkout: Have your agent quote a complete trip and create a hosted checkout page where a traveler can review the itinerary and pay. ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `JINKO_ADD_TRIP_ITEM` | Add Trip Item | Add one flight or hotel offer to an existing trip. Returns the successful mutation snapshot and a best-effort canonical trip read; if that read fails, the warning confirms the mutation succeeded and must not be retried blindly. | | `JINKO_CREATE_HOSTED_CHECKOUT` | Create Hosted Checkout | Quote a complete trip and create a hosted checkout URL for a person to review and pay. This tool neither opens checkout nor submits payment nor creates a booking; create a fresh checkout if the quote expires. | | `JINKO_CREATE_TRIP` | Create Trip | Create a new trip containing one flight or hotel offer. Returns the successful mutation snapshot and a best-effort canonical trip read; if that read fails, the warning confirms the mutation succeeded and must not be retried blindly. | | `JINKO_FIND_DESTINATIONS` | Find Destinations | Discover destinations reachable from one or more origins using cached fare data, with optional dates, budget, cabin, and passenger constraints. Increase offset to request another page; returned_count describes only this page. | | `JINKO_GET_HOTEL_DETAILS` | Get Hotel Details | Get descriptive property, policy, facility, image, and room metadata for one hotel. Rooms are descriptive and unpriced; use Search Hotels for current rates and bookable hotel offer IDs. | | `JINKO_GET_TRIP` | Get Trip | Read the canonical current state of a trip, including items, travelers, contact, quote and fulfillment state, totals, and booking references. Use this instead of relying on a prior mutation response. | | `JINKO_LIST_TRIP_ANCILLARIES` | List Trip Ancillaries | Create or reuse a price quote and list purchasable baggage, seat, meal, and other ancillary offers for a trip without creating checkout. Creating the quote can update the trip's quote state and consume Jinko account credit; completed quotes are reused while valid. If Jinko is still pricing, this tool polls until ready or times out; it never returns a hosted checkout URL. | | `JINKO_REMOVE_TRIP_ITEM` | Remove Trip Item | Remove one flight or hotel item from an existing trip. This is destructive. Returns the successful mutation snapshot and a best-effort canonical trip read; if that read fails, do not retry blindly and reconcile with Get Trip. | | `JINKO_REPLACE_TRIP_TRAVELERS_AND_CONTACT` | Replace Trip Travelers and Contact | Replace an existing trip's complete traveler list and optionally its booking contact. Travelers cannot be empty. Returns the successful mutation snapshot and a best-effort canonical read; a read warning must not trigger a blind retry. | | `JINKO_SEARCH_FLIGHT_CALENDAR` | Search Flight Calendar | Search cached priced itineraries for known origins and destinations across exact or flexible dates. This does not live-price fares; pass an itinerary's offer token to Search Flights before adding a fare to a trip. | | `JINKO_SEARCH_FLIGHTS` | Search Flights | Get live flight offers either by searching a route or by re-pricing one cached discovery offer. Provide exactly one of search or offer_token; re-pricing can return multiple alternatives and exact_match_found may be false. | | `JINKO_SEARCH_HOTELS` | Search Hotels | Search live hotel availability and priced room rates for dates, occupancy, and one location selector. Pass next_cursor by itself to continue the same search using Jinko's exact next offset. | | `JINKO_SELECT_ANCILLARIES` | Select Ancillaries | Replace the ancillary selections for one trip item using offer IDs from List Trip Ancillaries. This updates the quoted trip price but does not create checkout or submit payment. | ## Supported Triggers None listed. ## Troubleshooting ### 1. Why does Claude not use the Composio connector for Jinko? The connector can show as connected, but Claude must use it in each Jinko conversation. - Click + at the lower left of the chat, or type /. - Hover Connectors. - Turn on Composio. - Ask Claude to connect to Jinko again. ### 2. Why does Claude show an MCP server error before Jinko connects? Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Jinko. - Check that the connector URL is https://connect.composio.dev/mcp. - Connectors run from Anthropic's cloud, so your device network is usually not the problem. - Add the connector again from Customize > Connectors, then ask Claude to connect Jinko. - If it fails again, send the error and the ofid_ reference id to support@composio.dev. ### 3. Why does the Jinko authorization link not work? The Composio connector is one server. Your Jinko account connects separately when Claude asks for it. - If the browser does not open, or the link expires, ask Claude to retry the Jinko connection. - Composio creates a fresh Jinko authorization link. - Open that link in your browser and finish the Jinko sign-in. ### 4. Why do Jinko actions fail after they worked before? The Jinko connection can expire or lose permission. - Ask Claude to inspect the Jinko connection. - If the connection is unhealthy, disconnect it when Claude prompts you. - Reconnect the Jinko account and retry the action. - If Claude shows a permission prompt, approve it before Claude changes data in Jinko. - If the action still fails with a permission error, check that the connected account has that permission in Jinko itself. ### 5. How do I switch to a different Jinko account? Claude can manage the Jinko connection for you. - Ask Claude to disconnect or delete the current Jinko account. - Ask Claude to connect Jinko again. - Open the new Composio authorization link for Jinko. - Sign in with the other Jinko account in the browser. - After the account connects, ask Claude to retry the Jinko task. ### 6. Why is my Jinko connection missing in Claude Desktop or on a Team plan? The connector belongs to your Claude account, so your Jinko connection works in Claude Web, Desktop, and Cowork. - In Claude Desktop, open Customize > Connectors. - Next to Composio, click ⋮ and click Clear cache. - If Jinko tools still do not appear, click ⋮, disconnect, remove the connector, and add it again. - On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Jinko. ## Creating MCP Server - Stand-alone vs Composio SDK The Jinko MCP server connects Claude Web, Desktop, and Cowork to your Jinko account through Composio. Once connected, Claude can use the available Jinko tools and triggers to complete tasks on your behalf. ## Complete Code None listed. ## How to build Jinko MCP Agent with another framework - [ChatGPT](https://composio.dev/toolkits/jinko/framework/chatgpt) - [Hermes](https://composio.dev/toolkits/jinko/framework/hermes-agent) - [Atomic Agent](https://composio.dev/toolkits/jinko/framework/atomic-agent) ## Related Toolkits - [Google Calendar](https://composio.dev/toolkits/googlecalendar) - Google Calendar is a time management service for scheduling meetings, events, and reminders. It streamlines personal and team organization with integrated notifications and sharing options. - [Apaleo](https://composio.dev/toolkits/apaleo) - Apaleo is a cloud-based property management platform for hospitality businesses. It centralizes reservations, billing, and daily operations for smoother hotel management. - [Appointo](https://composio.dev/toolkits/appointo) - Appointo is an appointment booking platform for Shopify stores. It lets businesses add online scheduling to their websites with zero coding. - [Bart](https://composio.dev/toolkits/bart) - Bart is the Bay Area Rapid Transit system, providing fast public transportation across the San Francisco Bay Area. It helps commuters and travelers get real-time schedule info, plan routes, and stay updated on service changes. - [Blue Pillow Hotels & Stays](https://composio.dev/toolkits/bluepillow) - Blue Pillow Hotels & Stays is a hotel and stay discovery platform offering live offers, recommendations, and booking handoff. It helps surface and compare real-time deals and validate bookings for smoother reservations. - [Bookingmood](https://composio.dev/toolkits/bookingmood) - Bookingmood is commission-free booking software for rental businesses. It lets you manage reservations and sync bookings directly on your website. - [Booqable](https://composio.dev/toolkits/booqable) - Booqable is a rental software platform for managing inventory, bookings, and reservations. It helps businesses streamline rentals and keep track of every item with ease. - [Cal](https://composio.dev/toolkits/cal) - Cal is a meeting scheduling platform that offers shareable booking links and real-time calendar syncing. It streamlines the process of finding mutual availability to make scheduling effortless. - [Calendarhero](https://composio.dev/toolkits/calendarhero) - Calendarhero is a powerful scheduling platform that streamlines your calendar management across multiple services. It helps you efficiently schedule, reschedule, and organize meetings without the back-and-forth. - [Calendly](https://composio.dev/toolkits/calendly) - Calendly is an appointment scheduling tool that automates meeting invitations, availability checks, and reminders. It helps individuals and teams avoid endless email back-and-forth when booking meetings. - [Calendly MCP](https://composio.dev/toolkits/calendly_mcp) - Calendly is an appointment scheduling platform that manages event types, availability, and invites. Use it to automate booking, reduce back-and-forth, and surface open times quickly. - [Check Cherry](https://composio.dev/toolkits/check_cherry) - Check Cherry is a business management platform for photography and event service companies. It helps teams manage leads, bookings, appointments, offerings, payments, and workflows in one place. - [Cronfree Time Scheduler](https://composio.dev/toolkits/cronfree_time_scheduler) - Cronfree Time Scheduler is an API-based scheduler for recurring webhook calls. Use it to create and remove timezone-aware schedules without running cron. - [Etermin](https://composio.dev/toolkits/etermin) - eTermin is an online appointment scheduling platform for businesses to manage bookings. It streamlines client appointments, saving time and reducing scheduling conflicts. - [Evenium](https://composio.dev/toolkits/evenium) - Evenium is an all-in-one platform for managing professional events, from planning to analysis. It helps teams simplify event logistics, boost engagement, and track every detail in one place. - [Eventee](https://composio.dev/toolkits/eventee) - Eventee is a user-friendly event management platform for mobile and web. It boosts attendee engagement for in-person, virtual, and hybrid events. - [Eventzilla](https://composio.dev/toolkits/eventzilla) - Eventzilla is an event management platform for creating, promoting, and running events. It streamlines ticketing, registration, and attendee coordination for organizers. - [GoTable](https://composio.dev/toolkits/go_table) - GoTable is a restaurant management REST API for reservations, tables, guests, offers, availability, and webhooks. Use it to programmatically manage bookings, guest data, offers, and table availability. - [Humanitix](https://composio.dev/toolkits/humanitix) - Humanitix is a not-for-profit ticketing platform that donates 100% of profits to charity. It empowers event organizers to make social impact with every ticket sold. - [Ignav Flights](https://composio.dev/toolkits/ignav_flights) - Ignav Flights is a flight search API for airports, fares, itineraries, and booking links. It helps apps compare routes and prices fast, so travelers can find practical options sooner. ## Frequently Asked Questions ### What are the differences in Tool Router MCP and Jinko MCP? With a standalone Jinko MCP server, the agents and LLMs can only access a fixed set of Jinko tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Jinko and many other apps based on the task at hand, all through a single MCP endpoint. ### Can I use Tool Router MCP with Claude Cowork? Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Jinko tools. ### Can I manage the permissions and scopes for Jinko while using Tool Router? Yes, absolutely. You can configure which Jinko scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do. ### How safe is my data with Composio Tool Router? All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Jinko data and credentials are handled as safely as possible. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)