> ## Documentation Index
> Fetch the complete documentation index at: https://docs.widgety.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect in 5 minutes

> Add Widgety to your AI assistant. Pick your assistant below.

<Note>
  **You'll need:** your Widgety agency API key (it starts with `wgt_live_`). Don't have one? Ask your Widgety account manager.
</Note>

<Tabs>
  <Tab title="Claude">
    Works in Claude on the web and in the desktop app.

    <Steps>
      <Step title="Open connector settings">
        In Claude, go to **Settings → Connectors**, then choose **Add custom connector**.
      </Step>

      <Step title="Add Widgety">
        * **Name:** Widgety Cruise Search
        * **URL:** `https://cruise-search-mcp-ngzcfzacka-uc.a.run.app/mcp`

        Click **Add**.
      </Step>

      <Step title="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.
      </Step>

      <Step title="Try it">
        Start a new chat and ask:

        > Show me 7-night Caribbean cruises departing in February 2027.
      </Step>
    </Steps>

    <Tip>
      If Claude doesn't use Widgety, check the connector is switched on for that chat, using the tools icon in the message box.
    </Tip>
  </Tab>

  <Tab title="Microsoft Copilot">
    Usually set up once by your IT or digital team. Everyone using that Copilot agent then gets Widgety data.

    <Steps>
      <Step title="Add an MCP tool">
        In Copilot Studio, open your agent and go to **Tools → Add a tool → Model Context Protocol**.
      </Step>

      <Step title="Enter the server details">
        * **Server name:** Widgety Cruise Search
        * **Server URL:** `https://cruise-search-mcp-ngzcfzacka-uc.a.run.app/mcp`
        * **Transport:** Streamable HTTP
      </Step>

      <Step title="Set up authentication">
        Choose **API key**:

        * **Type:** Header
        * **Header name:** `X-API-Key`
        * **Value:** your Widgety agency API key
      </Step>

      <Step title="Test it">
        In the test pane, ask: "Which cruise lines can I sell?" You should see your agency's list.
      </Step>
    </Steps>

    <Warning>
      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.
    </Warning>
  </Tab>

  <Tab title="Other assistants">
    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:

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

    <Warning>
      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.
    </Warning>
  </Tab>

  <Tab title="Developers">
    **Claude Code**

    ```bash theme={null}
    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:

    ```bash theme={null}
    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 API**

    Use the same endpoint in the MCP connector, and pass your raw agency key as the connector's authorization token.
  </Tab>
</Tabs>

## What next?

<CardGroup cols={2}>
  <Card title="See it in action" icon="play" href="/connector/see-it-in-action">
    A real search, start to finish.
  </Card>

  <Card title="Everyday tasks" icon="list-check" href="/connector/tasks/find-cruises">
    Prompts you can copy and paste.
  </Card>
</CardGroup>