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
Option A: Setup Guide (recommended)
On your MCP server's bundle page in the MCPBundles dashboard:
- Copy the MCP server URL from the orange-bordered setup card.
- Expand Setup instructions on that card (the row below the install menu — lists Claude Code, CLI, Codex, and other hosts) and open the Craft Agents tab.
- Click Copy for Craft Agents — this copies your server-specific line:
Connect to https://mcp.mcpbundles.com/bundle/YOUR-SERVER
- 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 on the setup card — 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."
- Copy your MCP server URL from the setup card on the MCP server page.
- 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
- In Craft Agents, open Sources in the sidebar.
- Click Add Source (or +).
- Choose HTTP MCP and use this template (or copy from Setup instructions → Craft Agents):
{
"type": "mcp",
"name": "Your MCP Server",
"mcp": {
"transport": "http",
"url": "https://mcp.mcpbundles.com/bundle/YOUR-SERVER",
"authType": "oauth"
}
}
- Save and complete MCPBundles OAuth when prompted.
About craftagents:// deep links
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
| Layer | What it is | Where to set it |
|---|---|---|
| Service credentials | OAuth/API key for the external product | MCPBundles dashboard → Credentials |
| MCPBundles platform auth | Proves which workspace is calling the MCP URL | OAuth 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
- Confirm the MCP server is enabled in your MCPBundles dashboard.
- Connect service credentials for the providers on that server.
- Re-authenticate the MCP source in Craft Agents.
See Provider Credentials and Troubleshooting.
Next Steps
- Browse MCP servers
- Connect Credentials
- Claude Code setup — hosts that do support HTTP MCP install links