Get started
Quickstart
Connect any MCP-compatible client to your Vibiz workspace. There are two ways to authenticate: a one-click OAuth flow (recommended) or a manual API key.
Recommended: OAuth (one click)
With OAuth, your AI client opens a browser, you sign in to Vibiz, and the connection is wired up automatically — no token to copy, no config file to edit. We handle refreshes, scopes, and revocation for you.
Add Vibiz to your client
Point your MCP client at the Vibiz server URL — that’s all the information any client needs.
https://app.vibiz.ai/api/mcp- • In Claude Desktop, use Settings → Connectors → Add custom connector.
- • In Claude Code, run
npx @vibiz/vibiz— installs the official plugin (slash commands, subagent, post-commit nudge) and the MCP connection in one step. See the Claude Code page. - • In Cursor, use Settings → MCP → Add new MCP server and paste the URL.
Sign in to Vibiz
Your client opens a browser tab to vibiz.ai. Sign in with the same account you use for the app. Approve the connection and the browser hands the session back to your client.
Verify the connection
The Vibiz tools should now show up in your client’s tool picker. Try a prompt like “generate an ad image for our hero product” to confirm.
Manual: API key
Prefer a static credential? Mint a token from your workspace’s Developer page (sign in to app.vibiz.ai, open Developer → API keys) and add it as a Bearer header. Use this for headless agents, CI, or clients that don’t support OAuth.
{
"mcpServers": {
"vibiz": {
"url": "https://app.vibiz.ai/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_VIBIZ_API_KEY"
}
}
}
}Test it directly with curl:
curl https://app.vibiz.ai/api/mcp \
-H "Authorization: Bearer YOUR_VIBIZ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Next steps
- • Browse the tool reference for every available action.
- • Detailed setup for Claude Desktop, Claude Code, or Cursor.