Skip to main content

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.

​
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

1

Open MCP Server page

Click your avatar in the sidebar footer, then select MCP Server from the dropdown.
2

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.
3

Copy the MCP Config

After generating a key, the page displays a JSON configuration block. Click Copy Config to copy it to your clipboard.
4

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.
5

Start querying

Restart your AI tool. You should now see Experio’s tools available. Ask your AI tool to query Experio’s knowledge base.

​
MCP Configuration Format

The configuration uses the mcp-remote transport, which works with all MCP clients: 
{
  "mcpServers": {
    "experio": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-server.com/mcp",
        "--header",
        "Authorization: Bearer <your_exp_mc_key>"
      ]
    }
  }
}
The mcp-remote package is installed automatically via npx. Make sure you have Node.js installed on your machine.

​
Available Tools

Once connected, your AI tool has access to three Experio tools:
ToolDescription
list_assistantsDiscover available AI assistants and their capabilities
ask_experioAsk a question to an Experio assistant. Queries the knowledge graph, searches documents, and generates a report.
get_fileDownload 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
The full API key is never displayed after creation. Only the prefix is shown for identification purposes.

​
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.