Guide · Integrations
Set up the Entropia MCP Server
Connect your AI assistant directly to Entropia and interact with your data rooms in natural language. Browse documents, run full-text searches, read files, explore Q&A threads and analyse audit logs, all from inside your AI chat interface.
Updated June 2026·7 min read
Connection URL
All MCP clients use the same connection URL:
https://api.eu.entropia.io/mcp-server/mcpAuthentication is handled via OAuth 2.1. Your client opens a browser window to log in with your Entropia credentials the first time you connect.
Setup by client
Pick the AI client you use. The steps differ slightly, but the connection URL and the login flow are the same everywhere.
Claude.ai (web)
- Open claude.ai and go to Settings → Connectors.
- Click "Add custom connector" (or "Add MCP server"). Note: this action may be restricted by your organisation admin.
- In the pop-up, enter the name Entropia and paste the remote MCP server URL below.
- Click Add. A login window opens. Sign in with your Entropia account, then start a new conversation and ask Claude about your data rooms.
https://api.eu.entropia.io/mcp-server/mcpClaude for Work
Requires a workspace admin to enable the integration for the team.
- As a workspace admin, go to Settings → Connectors in your Claude for Work workspace.
- Add a new MCP integration with the connection URL below.
- Save. All workspace members can now use the integration in their conversations.
- Each member authenticates individually with their own Entropia credentials on first use.
https://api.eu.entropia.io/mcp-server/mcpClaude Desktop
- Open your Claude Desktop configuration file (paths below).
- Add the entropia server block to the mcpServers object.
- Save the file and restart Claude Desktop. On the first tool call, a browser window opens for authentication.
- macOS
~/Library/Application Support/Claude/claude_desktop_config.json- Windows
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"entropia": {
"type": "http",
"url": "https://api.eu.entropia.io/mcp-server/mcp"
}
}
}Restart Claude Desktop after saving. On the first tool call, a browser window opens to complete the login flow.
Claude Code
- Run the add command below in your terminal.
- Inside a Claude Code session, reconnect to trigger authentication. A browser window opens to complete the login flow.
claude mcp add --transport http entropia https://api.eu.entropia.io/mcp-server/mcpThen, inside a Claude Code session, reconnect to trigger authentication:
/mcp reconnect entropiaChatGPT
- Go to chatgpt.com and open Settings → Connectors.
- Click "Add custom connector".
- Paste the connection URL below.
- Follow the authentication prompt to connect your Entropia account.
https://api.eu.entropia.io/mcp-server/mcpUsage
Make sure the Entropia connector is toggled on. In most clients you'll find it under the "plus" button, then Connectors. Once it's active, your assistant can call the Entropia tools whenever a question needs them.
From there, just ask questions in natural language about your data rooms. The assistant decides which tools to call, reads what it needs, and answers. You stay in the chat the whole time.
Available tools
Once connected, your AI assistant has access to the following tools:
| Friendly name | Tool name | What it does |
|---|---|---|
| List data rooms | list_datarooms | Shows all data rooms you have access to. |
| Get data room details | get_dataroom | Details and usage stats for a specific data room. |
| Browse folder structure | list_folder_contents | Shows the folder/file tree as an ASCII diagram. |
| Get file info | get_file_metadata | File properties (size, page count, author, sheet names) without reading content. |
| Read document | read_document | Reads pages from PDFs, Word, PowerPoint and image files. |
| Read spreadsheet | read_spreadsheet | Reads an Excel sheet as a formatted table. |
| Search | search | Full-text search across all files, with fuzzy matching. |
| Read Q&A thread | read_thread_messages | Reads all messages in a Q&A thread. |
| Search Q&A threads | search_qa_threads | Searches Q&A threads by topic or keyword. |
| Get bidder context | get_bidder_group_context | Gets context about who a Q&A stream belongs to. |
| Preview analytics query | build_events_cte | Previews the SQL query used to filter audit events. |
| Run analytics query | run_analytics_query | Runs a query over the audit log and returns results. |
Example prompts
Here are some things you can ask your AI assistant once connected:
Exploring the data room
- “What data rooms do I have access to?”
- “Show me the folder structure of the ACME deal.”
- “What files are in the Legal section?”
Reading documents
- “Read pages 1 to 5 of the Share Purchase Agreement.”
- “Summarise the Financial Statements.”
- “What does the NDA say about confidentiality obligations?”
Searching
- “Search for 'indemnification' across all documents.”
- “Find all mentions of 'change of control' in the Legal folder.”
Analytics & audit
- “Who viewed the Financial Statements the most this week?”
- “Show me all file downloads by external users in the last 30 days.”
- “Which folders have had the most activity?”
Troubleshooting
The MCP integration option doesn't appear in my AI client.
Your account may not have the MCP feature enabled. Get in touch to request access and we'll enable it for you.
Contact usAuthentication fails or I'm redirected to an error page.
Make sure you're signing in with the same credentials you use on app.entropia.io. If you use SSO, ensure your identity provider session is active before connecting. 2FA must be disabled on the account used for MCP access.
The AI assistant says it can't find any data rooms.
Your account may not have been granted access to any data rooms yet. Ask your data room manager to add you as a member with the appropriate permissions.
A tool call fails with a permission error.
Access to files and folders is governed by the same permissions as the web app. If you can't see a file in Entropia, the MCP server won't be able to read it either.
read_document returns an error or empty content.
Not all file types are supported for content extraction. Ensure the file is a PDF, DOCX, PPTX, image or Excel spreadsheet. Encrypted or password-protected files cannot be read.
The analytics query times out.
Analytics queries have a 10-second limit. Try narrowing your query with date range filters, specific event families or user filters before running it.
The integration stops working after a while.
OAuth tokens expire. Reconnect the integration from your AI client's settings. For Claude Code, run /mcp reconnect entropia.
Privacy
When you connect an AI assistant to Entropia via MCP, your queries and the data room content retrieved to answer them are sent to the AI provider you are using (e.g. Anthropic, OpenAI). That transmission is governed by your agreement with that provider, not by Entropia.
- The MCP server only exposes data rooms and files your account already has permission to access.
- Entropia does not store or log the content of AI conversations.
- Tool calls are recorded in the audit log in the same way as any other user action, so data room managers retain full visibility.
For a full list of Entropia's sub-processors, including AI inference providers, see the Trust Center, and review your AI provider's data handling policies before using this integration with sensitive documents.