🔌MCP Setup Guide

The Euno AI Assistant can connect to compatible AI clients through the Model Context Protocol (MCP). This lets you explore your data model directly from tools such as Cursor, Claude Desktop, and other MCP-enabled assistants.

The recommended setup uses OAuth. The first time you use Euno MCP, your client will prompt you to sign in to Euno in a browser. If Euno can identify which persona to use, it will select it automatically. If Euno cannot identify a single clear persona, you will be asked to choose one.

This guide covers the standard direct MCP setup using OAuth.

Prerequisites

Before setting up MCP, make sure you have:

• access to Euno and at least one assigned persona

• an MCP-compatible client such as Cursor or Claude Desktop

Sign In with OAuth

In the recommended OAuth setup, your client will prompt you to sign in to Euno in a browser the first time you connect.

Personas in MCP

Euno MCP uses your active persona to determine what data and actions are available in the session.

• If Euno can identify which persona to use, it will select it automatically.

• This usually happens when you have a default persona, or only one available persona in the relevant account.

• If Euno cannot identify a single clear persona, you will be asked to choose one.

If you have access to more than one persona, you can ask your assistant to show your available personas and switch to another one during the session.

Choose Your Setup

Use the setup mode that matches your client's MCP capabilities:

Use this when	Recommended setup
Your client supports remote HTTP MCP servers	Direct connection (this page)
Your client does not support remote HTTP MCP servers, or you prefer a local stdio MCP server	MCP Bridge Setup
Interactive OAuth sign-in is not available, or you prefer manual API key and header configuration	Advanced API Key Setup

If you are not sure which option to use, start with the direct connection below.

Cursor Direct Connection

If your version of Cursor supports remote HTTP MCP servers, this is the simplest way to connect to Euno MCP.

1. Open Cursor Settings

2. Go to Tools & Integrations

3. Add a new MCP server. In the mcp.json file that opens, add:

   {
     "mcpServers": {
       "euno-assistant": {
         "type": "http",
         "url": "https://api.app.euno.ai/mcp"
       }
     }
   }

4. Save the file

5. The first time you use Euno MCP, Cursor will prompt you to sign in to Euno in a browser

6. After sign-in, you can start using Euno MCP in chat

Troubleshooting

Euno MCP does not appear in Cursor

1. Confirm that your mcp.json file is valid JSON

2. Save the file and refresh Tools & Integrations

3. Re-open Tools & Integrations and confirm that the Euno MCP server appears there

The Euno sign-in page does not open

1. Try the connection again

2. Check whether your browser prevented the sign-in page from opening

Euno asks you to choose a persona

This is expected when Euno cannot identify a single clear persona automatically.

1. Choose one of the offered personas to continue

2. If you want to change later, ask your assistant to show your available personas and switch to another one

Euno MCP is connected, but no tools appear

1. Make sure your active persona has access to the Euno resources you expect to use

2. Ask your assistant to show your available personas

3. If needed, switch to another persona and try again

Sign-in worked before, but now fails

1. Try the connection again

2. Remove and re-add the Euno MCP server entry if the issue persists

3. If the problem continues, contact your Euno team or support team

Available Tools

Tool	Description
euno_dynamic_instructions	Fetch current Euno MCP instructions, including account-specific metadata guidance
list_personas	Show the personas available in the current session
current_persona	Show the persona currently active for the session
switch_persona	Change the active persona for the session
fetch_single_resource	Retrieve details for a specific resource by URI
find_resource_by_name	Find a resource by name
find_resources_for_topic	Find resources related to a topic or keyword
get_upstream_lineage	Show upstream lineage for a resource
resource_impact_analysis	Show downstream impact for a resource
documentation_search	Search Euno documentation
documentation_get_full_document	Open a full documentation page
documentation_get_surrounding_context	Show the documentation context around a specific chunk
query_to_eql	Turn a natural-language request into an EQL query
fetch_eql_syntax	Show EQL syntax guidance
search_resources_eql	Search resources using an EQL query
count_resources_eql	Count resources matching an EQL query

---