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

# MCP Server

> Connect external AI tools to Experio's knowledge base via the Model Context Protocol

## Overview

The MCP Server feature lets you connect external AI tools — such as **Claude Desktop**, **Cursor**, **VS Code Copilot**, and other MCP-compatible clients — directly to Experio. Once connected, these tools can query your organization's knowledge graph, search documents, and generate reports through Experio's AI assistants.

Navigate to **MCP Server** from the user dropdown menu in the sidebar.

## Getting Started

<Steps>
  <Step title="Open MCP Server page">
    Click your avatar in the sidebar footer, then select **MCP Server** from the dropdown.
  </Step>

  <Step title="Generate an API Key">
    Click **Generate API Key**. A dialog shows your key (starting with `exp_mc_`). Copy it immediately — the key is shown only once and cannot be retrieved later.
  </Step>

  <Step title="Copy the MCP Config">
    After generating a key, the page displays a JSON configuration block. Click **Copy Config** to copy it to your clipboard.
  </Step>

  <Step title="Paste into your AI tool">
    Open your AI tool's MCP configuration file and paste the JSON. For example:

    * **Claude Desktop**: Edit `claude_desktop_config.json`
    * **Cursor**: Edit MCP settings in Cursor preferences
    * **VS Code**: Edit your MCP settings file

    Replace `<your_exp_mc_key>` in the config with the API key you copied.
  </Step>

  <Step title="Start querying">
    Restart your AI tool. You should now see Experio's tools available. Ask your AI tool to query Experio's knowledge base.
  </Step>
</Steps>

## MCP Configuration Format

The configuration uses the `mcp-remote` transport, which works with all MCP clients:

```json theme={null}
{
  "mcpServers": {
    "experio": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-server.com/mcp",
        "--header",
        "Authorization: Bearer <your_exp_mc_key>"
      ]
    }
  }
}
```

<Note>
  The `mcp-remote` package is installed automatically via `npx`. Make sure you have Node.js installed on your machine.
</Note>

## Available Tools

Once connected, your AI tool has access to three Experio tools:

| Tool                 | Description                                                                                                      |
| -------------------- | ---------------------------------------------------------------------------------------------------------------- |
| **list\_assistants** | Discover available AI assistants and their capabilities                                                          |
| **ask\_experio**     | Ask a question to an Experio assistant. Queries the knowledge graph, searches documents, and generates a report. |
| **get\_file**        | Download a file generated by ask\_experio (CSV exports, presentations, documents)                                |

### Typical Workflow

1. Call `list_assistants` to see which assistants are available
2. Call `ask_experio` with your question, assistant name, and an optional `thread_id`
3. If the response mentions a file (e.g., `/results/export.csv`), call `get_file` with the same `thread_id` to get a download URL

### Example Queries

Once connected, try asking your AI tool:

* "Use Experio to list all departments in the organization"
* "Ask Experio to export all employees as a CSV"
* "Query Experio about Cloud division employees and their skills"
* "Use Experio to create a PowerPoint about the organizational structure"

## Managing API Keys

### Viewing Keys

The MCP Server page shows all your active API keys with:

* Key prefix (first 16 characters for identification)
* Name (optional label you set when creating)
* Created date
* Last used date

<Note>
  The full API key is never displayed after creation. Only the prefix is shown for identification purposes.
</Note>

### Revoking Keys

To revoke an API key:

1. Click the trash icon next to the key
2. Confirm the revocation in the dialog

After revoking, any AI tool using that key will immediately lose access. You can generate a new key at any time.

### Multiple Keys

You can generate multiple API keys — for example, one for Claude Desktop and another for Cursor. Each key can be revoked independently.

## File Downloads

When Experio generates files (CSV exports, PowerPoint presentations, Word documents, PDFs), the `get_file` tool returns a **signed download URL**. These URLs:

* Expire after **10 minutes**
* Require no additional authentication (the URL itself is the authorization)
* Work in any browser or HTTP client

## Privacy and Security

* **Per-user API keys** — Each key is tied to your account. Other users cannot use your key.
* **Hashed storage** — API keys are stored as SHA-256 hashes. Even database administrators cannot see your raw key.
* **Revocable** — Keys can be revoked instantly from the MCP Server page.
* **Scoped access** — MCP tools respect the same data permissions as the web interface.
* **Signed file URLs** — Download links are cryptographically signed and time-limited.