> For the complete documentation index, see [llms.txt](https://ask.birdie.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ask.birdie.ai/integrations-and-data-ingestion/birdie-mcp-server/mcp-guide-claude-desktop.md).

# Claude Desktop Setup

Connecting Birdie to Claude Desktop lets you pull your feedback data, run analyses, and explore your customers’ feedback directly inside any Claude chat. The setup takes about a minute. Here's how to do it.

{% hint style="warning" %}
Claude Desktop evolves very rapidly, and the screenshots below may be outdated by the time you read this guide. They are, however, representative of the steps needed to connect it to the Birdie MCP Server
{% endhint %}

> *Before you start*
>
> Make sure your Claude admin has already added Birdie's custom MCP connection to your workspace. If they haven't, share [this article](/integrations-and-data-ingestion/birdie-mcp-server.md#technical-details) with them.

## Step 1: Log into your Birdie account

Head to <https://app.birdie.ai> and sign in. You must have an active Birdie session during the authorization step.

<div align="center"><img src="/files/ixFTNV47qQZ8aoJywkpT" alt="Logging into Birdie..."></div>

## Step 2: Open Customize in Claude

In Claude, click on Customize.

<div align="center"><img src="/files/0seCOzr6DAX0rRQKng81" alt="Customizing Claude Desktop connectors..."></div>

## Step 3: Go to Connectors and find Birdie

Inside Customize, click on Connectors and look for Birdie in the “Not connected” list. Don't see Birdie in the list? That usually means the custom MCP connection hasn't been added to your workspace yet. Ask your Claude admin to set it up using [this article](/integrations-and-data-ingestion/birdie-mcp-server.md#technical-details).

<div align="center"><img src="/files/Apq9FBbdqzyXrogh3rhR" alt="Connecting to Birdie..."></div>

## Step 4: Click Connect and approve access

Click Connect next to Birdie. An authorization page will open in your browser asking you to approve the connection.

<div align="center"><img src="/files/vzBP0hXqvQe2KCu5RSUH" alt="Approving Birdie access..."></div>

## Step 5: You're connected

Once you approve, Birdie's MCP connector is added to your list. From now on, just mention Birdie in any Claude chat to start pulling data straight from your accounts.

<div align="center"><img src="/files/laE9nx3ewUPCVDWQr3e3" alt="Connected..."></div>

*That's it. You're ready to start asking Claude questions about your customers’ feedback, NPS, CSAT, and more.*


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ask.birdie.ai/integrations-and-data-ingestion/birdie-mcp-server/mcp-guide-claude-desktop.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.