Skip to main content

Craft Agents Integration

Craft Agents is an open-source MCP host — a desktop app that connects to external MCP servers as sources. It is not an MCP server you enable inside MCPBundles.

Craft does not publish a one-click MCP install hotlink (no equivalent to Cursor's cursor://…/mcp/install or Goose's goose://extension?url=…). Their documented connection paths are chat and manual source config.

Requirements​

  • Craft Agents installed (download)
  • An MCP server enabled in your MCPBundles dashboard
  • Credentials connected for the providers on that MCP server

Time to complete: 2-3 minutes

On your MCP server's bundle page in the MCPBundles dashboard:

  1. Expand Quick Setup and open the Craft Agents tab in the setup guide.
  2. Click Copy for Craft Agents — this copies your server-specific line:
Connect to https://mcp.mcpbundles.com/bundle/YOUR-SERVER
  1. Paste in Craft Agents chat. The built-in agent configures the HTTP MCP source and walks you through OAuth.

Craft is not in the one-click install dropdown — it has no MCP install hotlink like Cursor or Goose.

Option B: Paste in Craft chat (manual)​

Craft's MCP connection guide says: "Just ask your agent."

  1. Copy your MCP Server URL from the MCPBundles dashboard Quick Setup section.
  2. In Craft Agents, start a new chat and paste:
Connect to https://mcp.mcpbundles.com/bundle/YOUR-SERVER

The built-in agent configures the HTTP MCP source and walks you through OAuth.

Option C: Manual Sources setup​

  1. In Craft Agents, open Sources in the sidebar.
  2. Click Add Source (or +).
  3. Choose HTTP MCP and use this template:
{
  "type": "mcp",
  "name": "Your MCP Server",
  "mcp": {
    "transport": "http",
    "url": "https://mcp.mcpbundles.com/bundle/YOUR-SERVER",
    "authType": "oauth"
  }
}
  1. Save and complete MCPBundles OAuth when prompted.

Craft documents a craftagents:// URL scheme for app navigation (open a view, pre-fill a chat message). It is not an MCP server install endpoint. Those links only work when Craft Agents is installed and registered as the protocol handler on your machine.

For MCP setup, use chat or Sources — not a web-page install button.

Authentication​

LayerWhat it isWhere to set it
Service credentialsOAuth/API key for the external productMCPBundles dashboard → Credentials
MCPBundles platform authProves which workspace is calling the MCP URLOAuth in Craft on first connect, or workspace API key header for headless

The MCP URL is the same for every user: https://mcp.mcpbundles.com/bundle/{slug}. There is no per-user URL or ?token= query parameter.

Verify connection​

In Craft Agents, run /tools -v in a session or ask: "What MCP tools do you have from MCPBundles?"

Troubleshooting​

"craftagent" not found in MCPBundles catalog​

Craft Agents is the host app, not a product in the MCPBundles catalog. Add your bundle MCP URL as a source inside Craft.

OAuth or auth errors​

  1. Confirm the MCP server is enabled in your MCPBundles dashboard.
  2. Connect service credentials for the providers on that server.
  3. Re-authenticate the MCP source in Craft Agents.

See Provider Credentials and Troubleshooting.

Next Steps​