Connecting your IDE
Mint an API key on the hosted dashboard and paste a snippet — Claude Code, Cursor, Claude Desktop, VS Code, and Windsurf supported.
The hosted MCP endpoint is a single HTTP URL. Every editor that supports MCP can talk to it once you've minted an API key.
Mint an API key
- Sign in at repowise.dev.
- Open Settings → Editor.
- Click Generate key — name it after the editor you'll use it from.
- Copy the snippet for your editor below.
Keys are scoped per repo or per workspace and revocable any time.
Snippets
Add to ~/.claude/settings.json (or paste into Claude Code's MCP
panel):
{
"mcpServers": {
"repowise": {
"transport": "http",
"url": "https://mcp.repowise.dev",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Restart Claude Code. Then ask: "Give me a tour of this codebase."
The agent should call get_overview against the hosted endpoint.
Drop the same mcpServers block into ~/.cursor/mcp.json. Restart
Cursor.
Add to claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/ - Windows:
%APPDATA%\Claude\
Use the same mcpServers block. Restart Claude Desktop.
Install the MCP extension. In its settings, add a server:
- Name —
repowise - Transport —
http - URL —
https://mcp.repowise.dev - Authorization header —
Bearer YOUR_API_KEY
Settings → MCP servers → Add server. Use the same transport, URL, and authorization header.
Targeting a specific repo or workspace
The hosted server is workspace-aware. Pass repo="<alias>" to any
tool to target a specific repo, or repo="all" to federate across
your whole workspace. See Workspace MCP mode.
Verify it works
Ask your agent something the model can't possibly know without calling repowise:
What are the current hotspot files in this repo?
The agent should call get_overview (or get_risk) and answer with
specific file names, churn percentiles, and owners. If it falls back
to greps and reads, the MCP connection isn't established.
Rotate or revoke
Settings → Editor shows every active key. Click Revoke to invalidate. Generate a new one, paste it in, restart your editor.
Self-hosted instead? No API key needed. repowise init writes
.mcp.json for you and the editor talks to a local stdio process.
See Quickstart → Self-hosted.
Hosted vs self-hosted
Both modes ship the same intelligence layers, the same seven MCP tools, and the same dashboard. The differences are about ops, billing, and team features — not about what the agent can do.
Dashboard tour
What lives behind sign-in at repowise.dev/dashboard — the hosted control plane for your indexed repos, workspaces, MCP keys, billing, and team.