Integration Guides
Claude Desktop
Set up ATOMS MCP Server in Claude Desktop
Claude Desktop Integration
Claude Desktop supports MCP servers natively. Once configured, you can interact with your ATOMS projects directly in conversation.
Install and authenticate
npm install -g @atoms-tech/atoms-mcp
npx @atoms-tech/atoms-mcp loginEdit your Claude Desktop config
Open your config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Add the ATOMS MCP server:
{
"mcpServers": {
"atoms-mcp": {
"command": "npx",
"args": ["@atoms-tech/atoms-mcp"]
}
}
}Restart Claude Desktop
Quit and reopen Claude Desktop. You should see the ATOMS tools available in the tools menu (hammer icon).
Verify
Type in Claude:
"Check my ATOMS connection"
You should see your email and authentication status returned by atoms_status.
Interactive MCP Apps
Claude Desktop supports MCP Apps, which means 5 tools will render interactive visual interfaces:
- atoms_get_coverage : Coverage heatmap
- atoms_export_mermaid : Pan/zoom Mermaid diagram
- atoms_trace : Force-directed dependency graph
- atoms_project_summary : Compliance dashboard with charts
- atoms_bulk_import : Color-coded import results table
These apps render automatically when Claude calls the tool. No additional setup is needed.
Troubleshooting
| Issue | Solution |
|---|---|
| Tools don't appear | Verify the config JSON is valid and restart Claude Desktop |
| "Not authenticated" error | Run npx @atoms-tech/atoms-mcp login in your terminal |
| "Token expired" | Run npx @atoms-tech/atoms-mcp login to re-authenticate |
| Slow responses | Check your network connection to Supabase |