Add MCP Server
Connect MCP (Model Context Protocol) servers to extend your Zero Docs chat agent with custom tools and capabilities. MCP servers can provide specialized functionality like database queries, API integrations, or data transformations that your agent can use when responding to user questions.
Step 1: Access MCP Servers
Navigate to your project's MCP Servers configuration:
- Select your project from the sidebar
- Expand the Integrations section
- Click MCP Servers
If you haven't connected any servers yet, you'll see an empty state with the message "No MCP servers connected."
Step 2: Start Adding a Server
Click the Add MCP Server + button to open the connection form.
Step 3: Enter Server Details
Server URL
Enter the full URL of your MCP server:
https://mcp.example.com
The system will probe this URL to verify connectivity and discover available tools.
Server Name (Optional)
The server name is auto-detected from the MCP server after connection. You can leave this field empty unless you want to specify a custom value before connecting.
Display Name (Optional)
Provide a human-readable display name for the server. This is also auto-detected but can be customized for clarity in your integrations list.
Step 4: Choose Authentication Method
Select the authentication type that matches your MCP server's requirements:
OAuth (Auto-Registration)
OAuth with dynamic client registration. No credentials needed — the server handles client registration automatically.
- Select OAuth (Auto-Registration) from the Auth Type dropdown
- Review the explanation text
- Click Connect to authorize
No credential fields are required for this method.
OAuth (App Credentials)
Use this method if you have pre-registered OAuth credentials with the MCP server provider.
Fields required:
| Field | Description |
|---|---|
| Authorization URL | OAuth authorization endpoint |
| Token URL | OAuth token exchange endpoint |
| Client ID | Your registered OAuth client identifier |
| Client Secret | Your OAuth client secret (masked) |
| Scope | OAuth scopes (defaults provided) |
API Key
Use this method if your MCP server authenticates via API key headers.
Fields required:
| Field | Description |
|---|---|
| API Key Header | Header name (e.g., X-API-Key) |
| API Key | Your API key value (masked) |
Open (No Auth)
No authentication required. The MCP server is publicly accessible.
- Select Open from the Auth Type dropdown
- Review the explanation text
- Click Connect to discover tools
Step 5: Connect the Server
After filling in the required fields for your chosen authentication method:
- Click the Connect button
- Monitor the connection status message area for feedback
- If using OAuth (Auto-Registration), complete the authorization flow in the popup window
The system will attempt to connect to the server, verify authentication, and discover available tools.
Step 6: Verify Connection
Once connected successfully, your MCP server will appear in the MCP Servers list. The chat agent can now access tools provided by this server when responding to user queries.
Next Steps:
- Test your chat agent to verify MCP tools are available: Testing the Chat Agent
- Add additional sources to expand your knowledge base: Adding Sources