Connect in 5 minutes

You’ll need: your Widgety agency API key (it starts with wgt_live_). Don’t have one? Ask your Widgety account manager.

Claude
Microsoft Copilot
Other assistants
Developers

Works in Claude on the web and in the desktop app.

Open connector settings

In Claude, go to Settings → Connectors, then choose Add custom connector.

Add Widgety

Name: Widgety Cruise Search
URL: https://cruise-search-mcp-ngzcfzacka-uc.a.run.app/mcp

Click Add.

Authorise with your key

Click Connect. A Widgety page opens in your browser.Paste your agency API key, then click Authorize connector. The key authorises the connection once. Claude never sees it.

Try it

Start a new chat and ask:

Show me 7-night Caribbean cruises departing in February 2027.

If Claude doesn’t use Widgety, check the connector is switched on for that chat, using the tools icon in the message box.

Usually set up once by your IT or digital team. Everyone using that Copilot agent then gets Widgety data.

Add an MCP tool

In Copilot Studio, open your agent and go to Tools → Add a tool → Model Context Protocol.

Enter the server details

Server name: Widgety Cruise Search
Server URL: https://cruise-search-mcp-ngzcfzacka-uc.a.run.app/mcp
Transport: Streamable HTTP

Set up authentication

Choose API key:

Type: Header
Header name: X-API-Key
Value: your Widgety agency API key

Test it

In the test pane, ask: “Which cruise lines can I sell?” You should see your agency’s list.

Everyone using the agent shares one API key, so they all see the same cruise lines. If teams need different access, ask your account manager for a key per team.

Any assistant that supports remote MCP servers over Streamable HTTP can use Widgety.

Setting	Value
Server URL	`https://cruise-search-mcp-ngzcfzacka-uc.a.run.app/mcp`
Transport	Streamable HTTP
Sign in with a browser (OAuth)	Supported. You paste your key on a Widgety page.
Or use a header	`X-API-Key: <your agency API key>`
Or use a bearer token	`Authorization: Bearer <your agency API key>`

Many desktop tools use a config file like this:

{
  "mcpServers": {
    "widgety-cruise": {
      "type": "http",
      "url": "https://cruise-search-mcp-ngzcfzacka-uc.a.run.app/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Treat your API key like a password. Don’t paste it into a chat message, and don’t commit config files containing it to shared repositories.

Claude Code

claude mcp add --transport http widgety-cruise https://cruise-search-mcp-ngzcfzacka-uc.a.run.app/mcp

This opens the Widgety authorisation page in your browser. To skip it and use your key directly:

claude mcp add --transport http widgety-cruise https://cruise-search-mcp-ngzcfzacka-uc.a.run.app/mcp \
  --header "X-API-Key: YOUR_API_KEY"

Claude APIUse the same endpoint in the MCP connector, and pass your raw agency key as the connector’s authorization token.

Start here

Everyday tasks

Help

What next?

See it in action

Everyday tasks

​What next?

See it in action

Everyday tasks

What next?