← Back to dashboard

Connect an AI agent

Any MCP-compatible agent — Claude Desktop, ChatGPT, Gemini CLI, or your own — can be wired to your marketplace account in two steps: install the .mcpb extension, then approve the one-time OAuth consent in your browser.

1. MCP server

This is the address your agent will call. It's served by the same Cloudflare Worker that runs the website.

Server URL: …
Transport: Streamable HTTP
Auth: OAuth 2.1 (Authorization Code + PKCE S256)

2. Pre-registered OAuth client

The .mcpb uses this client_id to start the authorization-code flow. The same Worker also supports Dynamic Client Registration (RFC 7591) for self-serve integrations.

client_id: claude-demo
client_secret: demo-secret-not-for-production-please-change
Redirect URI: http://127.0.0.1:<port>/callback — loopback, port picked by the client at runtime (SEP-103 / MCP §"Loopback Redirect URIs")
Scopes: posts:read, posts:write

Demo only. The secret above is hard-coded for the demo. Rotate it before sharing the deployment publicly.

3. Download the extension

Save this .mcpb file and drag it into Claude Desktop. The manifest points to the MCP server URL above; once installed, Claude will start the OAuth flow on first use.

Download aircargo-mcp.mcpb

Haven't generated the file yet? Click here to build it now.

If the download above returns 404, the build script hasn't run yet. Run it from the project root:

npm run build:mcpb

Or, on the first deploy, the Worker exposes a POST /connect/mcpb endpoint that returns a freshly-built .mcpb for the URL you specify below.

4. Install in Claude Desktop

Open Claude Desktop. Quit it completely first (Cmd-Q on macOS) so the extension loader picks up the new file.
Drag the .mcpb into the chat window. Claude will pop a confirmation dialog — click Install.
Approve the OAuth consent. On the first tool call, your browser opens to this Worker's consent screen. Sign in as demo / demo123 and click Allow.
Done. Claude now sees your drafts, the RFQ / availability schemas, and the aircraft compatibility check. Try the prompts in the next section to drive the demo.

Try this in Claude

These prompts are exposed as MCP prompt templates. Type them verbatim, or paraphrase — the agent knows what to do.

"Show me my active posts" — reads platform://my-posts.
"Help me draft a new RFQ for refrigerated cargo from Frankfurt to Dubai next month" — uses the draft_new_rfq prompt.
"Check my drafts" — uses check_drafts to validate every draft and surface the first blocker.
"Validate draft D-42" — direct tool call.
"Find availability that matches my RFQ draft" — uses find_match_for_rfq.

Discovery endpoints

Standards-compliant clients can self-configure from these documents (RFC 8414 + RFC 9728).

Authorization server: /.well-known/oauth-authorization-server
Protected resource: /.well-known/oauth-protected-resource