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

# Getting Started with Goose Desktop

> Learn how to connect Goose Desktop with MCP Server, create tokens, and enable secure AI-powered access to your data platform.

# Getting Started with Goose Desktop

Configure Collate's MCP Server to interact with the [Goose](https://github.com/aaif-goose/goose) AI agent.

## Prerequisites

For this guide, you'll need:

* [nvm](https://github.com/nvm-sh/nvm) and npx/node version 22.
* Collate v1.8.0 or later. Upgrade your version of Collate with [this guide](https://docs.open-metadata.org/latest/deployment/upgrade).
* [Goose Desktop](https://goose-docs.ai/docs/quickstart/).
* The Collate [MCP Application installed and a Personal Access Token generated](/ai-2-0/how-to-guides/mcp#adding-an-mcp-server-to-collate).

## Adding your Collate MCP Server to Goose Desktop

This how-to guide uses Goose Desktop for macOS. Make sure you already have an [LLM Provider configured](https://goose-docs.ai/docs/quickstart/#configure-provider) before prompting.

* Navigate to Goose Desktop's Settings, then under **Extensions**, select **+Add custom extension**.

<img src="https://mintcdn.com/collatedocs/NrIZfP8Avf1SnI7W/public/images/how-to-guides/mcp/goose-settings.jpg?fit=max&auto=format&n=NrIZfP8Avf1SnI7W&q=85&s=a4a21933f414a7580d0d16adc4a30653" alt="Goose settings" width="3414" height="2134" data-path="public/images/how-to-guides/mcp/goose-settings.jpg" />

* The custom extension should have the following information:
  * **Extension Name**: `Collate`.
  * **Command**: paste the following command:
    ```
    npx -y mcp-remote <YOUR-Collate-SERVER>/mcp --auth-server-url=<YOUR-Collate-SERVER>/mcp --client-id=Collate --verbose --clean --header Authorization:${AUTH_HEADER}
    ```
    * If you're running [it locally](https://docs.open-metadata.org/latest/quick-start/local-docker-deployment), your command will look like this:
      ```
      npx -y mcp-remote http://localhost:8585/mcp --auth-server-url=http://localhost:8585/mcp --client-id=Collate --verbose --clean --header Authorization:${AUTH_HEADER}
      ```
  * Add one **Environment Variable**:
    * **Variable name** is `AUTH_HEADER`.
    * **Value** is `Bearer <YOUR-Collate-PAT>`.

<img src="https://mintcdn.com/collatedocs/NrIZfP8Avf1SnI7W/public/images/how-to-guides/mcp/goose-mcp-settings.jpg?fit=max&auto=format&n=NrIZfP8Avf1SnI7W&q=85&s=9568b42ed737133ea25096911b28553c" alt="Configuring Collate MCP Server" width="3414" height="2134" data-path="public/images/how-to-guides/mcp/goose-mcp-settings.jpg" />

* Select **+Add** to store this environment variable.

<img src="https://mintcdn.com/collatedocs/NrIZfP8Avf1SnI7W/public/images/how-to-guides/mcp/goose-mcp-settings.jpg?fit=max&auto=format&n=NrIZfP8Avf1SnI7W&q=85&s=9568b42ed737133ea25096911b28553c" alt="Configuring Collate MCP Server" width="3414" height="2134" data-path="public/images/how-to-guides/mcp/goose-mcp-settings.jpg" />

* Select **Add Extension**.

<img src="https://mintcdn.com/collatedocs/NrIZfP8Avf1SnI7W/public/images/how-to-guides/mcp/goose-add-extension.jpg?fit=max&auto=format&n=NrIZfP8Avf1SnI7W&q=85&s=f5e1259ca0fc5f2759636dea6378139e" alt="Adding extension" width="3412" height="2131" data-path="public/images/how-to-guides/mcp/goose-add-extension.jpg" />

<img src="https://mintcdn.com/collatedocs/NrIZfP8Avf1SnI7W/public/images/how-to-guides/mcp/goose-success.jpg?fit=max&auto=format&n=NrIZfP8Avf1SnI7W&q=85&s=2abe3349a615cf84f96000b4e994dd5a" alt="Collate successfully added" width="3413" height="2132" data-path="public/images/how-to-guides/mcp/goose-success.jpg" />

## Prompt to Read from Collate

This part of the guide assumes that you have assets in Collate. Add data assets into Collate using the [connectors guide](https://docs.open-metadata.org/latest/connectors).

Select a model from Goose and paste the following prompt to have it read from Collate:

```
What tables do you have access to in Collate?
```

For more sample use cases with MCP, check out [our blog](https://collatedata.medium.com/mcp-sample-uses-in-collate-b7846864f63b).

### Reach Out on Slack

With MCP, Collate users are finding new ways to use the platform all the time. If you've got a great new use case, show it off in [Slack](https://slack.open-metadata.org/).