Have your own data or tools behind an MCP server (Model Context Protocol, the standard AI assistants use to call external tools)? Add it as a custom MCP and your agent can use its tools like any built-in connection. You can register several servers, and each shows up as its own card under Custom connections on the Connections page.

What you can ask

“What tools does my CRM server expose?”
“Look up the record for jane@acme.com in my internal wiki.”
“Create a new entry in my tracker.” (asks for approval before running)

Connecting

  1. Open Connections in the dashboard and click Add custom MCP.
  2. Paste the server URL (the full MCP endpoint, e.g. https://example.com/mcp). A name is optional, and if you leave it blank Expertise uses the name the server advertises, or its hostname.
  3. Click Connect. Expertise works out how the server wants you to sign in. If it uses OAuth (the browser sign-in flow), you are sent to the provider to authorize access and returned to the dashboard when you approve.
  4. Expertise validates the server live and lists the tools it found.
Servers that authenticate with a static token instead of a browser sign-in are set up under Advanced authentication in the same dialog:
  • Custom headers, for servers that take a token in a header such as Authorization: Bearer ....
  • OAuth client credentials, for OAuth servers that do not hand out clients automatically and gave you a client ID (and sometimes a secret) to use.

Managing a server

Each card has a Manage button. The dialog shows the server’s status, its host, the header names it uses (values stay hidden), and the tools discovered so far, plus Edit and Remove. Edit is also where you upload a logo for the connection: PNG, JPEG, or WebP, 5 MB maximum, and square images work best.

Good to know

  • The server must be reachable from the internet over Streamable HTTP (the MCP transport for remote servers). Servers on private or internal addresses are rejected.
  • URL, headers, and tokens are stored as secrets. Some vendors embed a token in the URL itself, so the full URL is never shown again after you save it. To change the URL or a header later, re-enter both.
  • Reads run freely, writes wait for approval. Tools with clearly read-shaped names (list, get, search, find, read, discover) run without asking; every other tool pauses for your approval first.
  • If an OAuth sign-in expires and cannot be renewed, the card shows Sign in again. Open Manage and click Sign in to reauthorize; the server keeps its name, logo, and settings.
  • If your server is down, its card shows Needs attention and the agent keeps the last-known tool list until the server is reachable again.