# AI Agent

### Install Birdie MCP Server

1. In Crisp left sidebar, click on <mark style="color:$warning;">AI Agent</mark>.
2. Go to the bottom of the new AI Agent menu and click on <mark style="color:$warning;">Integrations & MCP</mark>.
3. In External MCP Servers click on <mark style="color:$warning;">Add MCP Server</mark>.
4. Enter this URL: [`https://app.birdie.so/api/v1/crisp/mcp`](https://app.birdie.so/api/v1/crisp/mcp), don't change the Authentication section, and click <mark style="color:$warning;">Add MCP Server</mark>.
5. Once the MCP opens, give it a name, e.g. `Birdie MCP`, and paste this description:

{% code overflow="wrap" %}

```
This MCP server allows Hugo to create Birdie screen recording requests for customers during support conversations. Use it whenever a customer needs to share a bug reproduction, visual issue, UI problem, console error, or workflow issue through a screen recording.
```

{% endcode %}

Let the other parameters, and at the top of the screen enable the toggle <mark style="color:$warning;">Enable this MCP server</mark>.

### Instruct Hugo how to use Birdie MCP

1. In the AI Agent menu, click on <mark style="color:$warning;">Instructions</mark>.
2. Click on the <mark style="color:$warning;">New</mark> button to create a new instruction.
3. Give it a name, e.g. `Require a Screen Recording`.
4. Paste the following prompt in <mark style="color:$warning;">Description</mark> field - note that you can adapt it according to your needs and the name you gave to the MCP server:&#x20;

{% code overflow="wrap" %}

```
When a user reports that something is not working or they found a bug, you can propose them to make a screen recording to help diagnose the issue: in that situation, use Birdie MCP to require a recording link from Birdie backend, and if possible provide the end-user email. The recording will be automatically sent into the conversation by Birdie once the recording will be finished.
```

{% endcode %}

Click on <mark style="color:$warning;">Create instruction</mark>.

Now Hugo should be able to request a Screen Recording when needed!


---

# Agent Instructions: 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:

```
GET https://docs.birdie.so/birdie-docs/helpdesk/crisp/flows/ai-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.