Licensed to be used in conjunction with basebox, only.
// integration
MCP Connectors
Applies to
Product: Cloud · Server · Audience: Developer / Integrator · Administrator
Available from basebox 1.8.0
MCP connectors are a new feature available from the basebox 1.8.0 release. Earlier basebox versions do not include this functionality.
basebox can extend the assistant with MCP (Model Context Protocol) connectors — external tools the assistant can call on your behalf, such as web search or your internal wiki.
This section documents every MCP connector currently supported by basebox: what it does, what an administrator needs to configure, and (where applicable) how to obtain the credentials it needs.
On basebox Server, platform operators can deploy connector services with the basebox Helm chart. See Deploy MCP Connectors with Helm.
Security and safety
Connectors that reach the open web — above all Web Search — are powerful, but they also carry real security and privacy considerations. Before enabling them, we recommend reading our plain-language overview of how basebox keeps web search as safe as it reasonably can be, the risks that remain, and how to set it up sensibly:
- Introduction to Web Search Security — a short, readable guide for administrators and decision-makers. It explains how web search works on basebox Server, what can go wrong (in plain terms), the safeguards in place today, and the options for rolling it out.
For a technical explanation of how basebox ensures that each user can only access data they are already permitted to see in a connected system, including a full sequence diagram of a tool call:
- MCP Permission and Authorization Flow — covers per-user credential forwarding, the access control gate, and the key security properties of the design.
Currently Supported Connectors
| Connector | Purpose | Auth required |
|---|---|---|
| Calculator | Perform calculations | No |
| Web Search | Live web search on the European Staan index (Qwant + Ecosia); DuckDuckGo available as an alternative | Optional (admin-level API key; shared basebox account otherwise) |
| Search and read messages through IMAP | Yes (per-user credentials) | |
| DokuWiki | Search and read pages from a self-hosted DokuWiki | Yes (user/pass or token) |
| YouTrack | Query and update YouTrack issues | Yes (permanent token) |
More connectors will be added over time. If you need a connector that is not yet listed, please contact basebox support.
How connectors are enabled
All connectors are managed by the basebox administrator from the Connectors page in the admin UI:
- Open Admin → Connectors.
- Find the connector you want to enable.
- Fill in the required fields (such as the URL). Users add personal tokens themselves.
- Use Test connection to verify the configuration.
- Toggle the connector On.
Once enabled, the connector becomes available to users in the apps where it is enabled.