Skip to main content

Connect external MCP servers

Dynamic MCP lets AgentDock connect to other MCP servers without restarting or rebuilding. Examples include design platforms, task systems, search services, and local analysis tools.

Simplest usage​

Tell the agent what to connect:

Connect this MCP server: https://mcp.example.com/mcp
Use example as its name, store the authentication token in its isolated environment, and verify that its tools can be listed.

The agent registers the server, stores credentials in its isolated environment, refreshes the connection, and verifies it with a read-only call.

Two transport options​

HTTP MCP​

Use HTTP for services that already expose a network endpoint:

https://mcp.example.com/mcp

Authentication data is mapped from an isolated environment variable to an HTTP header. Registry data stores only the variable name, never the actual token.

Local stdio MCP​

Use stdio for command-line MCP servers installed on the same machine. You need to provide:

  • The absolute path to the executable.
  • Launch arguments.
  • An optional working directory.
  • Any required environment variables.

A local MCP server inherits the operating-system permissions of the AgentDock process, so review its source before installation.

Credential storage​

Do not place tokens, cookies, passwords, or OAuth codes directly in chat history, a README, or MCP registry data.

Ask the agent to store secrets in the MCP server's isolated environment. Configuration listings show variable names and status, not secret values.

Refresh the MCP connection after updating credentials.

Verify the connection​

You can ask the agent:

List the tools provided by the example MCP server, inspect the parameters of one read-only tool, and complete one call without side effects.

If verification fails, check whether the server is enabled, whether the URL or command is correct, whether all required variables are configured, and whether the upstream service is reachable.

Manage existing MCP servers​

Common operations include:

  • View and inspect configuration.
  • Enable, disable, or refresh a connection.
  • Update or remove isolated environment variables.
  • Remove a server that is no longer used.

See Tools for exact actions and parameters.