Skip to content

MCP Connectors

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.

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-premise, what can go wrong (in plain terms), the safeguards in place today, and the options for rolling it out.

Currently Supported Connectors

Connector Purpose Auth required
Web Search Live web search via DuckDuckGo No
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:

  1. Open Admin → Connectors.
  2. Find the connector you want to enable.
  3. Fill in any required fields (URL, credentials).
  4. Use Test connection to verify the configuration.
  5. Toggle the connector On.

Once enabled, the connector becomes available to end users in the chat.

Help