MCP Server Runbook: Adding Internal MCP Server Integrations for Remote Platforms

This runbook provides step-by-step instructions for creating new internal MCP server integrations in Dust that connect to remote platforms (e.g., Jira, HubSpot, Salesforce, etc.).

MVP Fast Path

For a minimal new server (no OAuth, no external API yet — just the skeleton to register and test):

1. Create front/lib/api/actions/servers/{provider}/metadata.ts with a literal metadata array
2. Create front/lib/api/actions/servers/{provider}/tools/index.ts with stub handlers
3. Create front/lib/api/actions/servers/{provider}/index.ts with createServer
4. Register in constants.ts and servers/index.ts
5. Add the server to SERVER_SOURCES in bm25_tool_search_utils.test.ts
6. Add at least one BM25 query case to bm25_tool_search.test.ts

See the BM25 Tests section below for the test setup. This gives you a runnable skeleton with type-checked tool descriptions before writing any real API calls.

Quick Reference