Documentation
Connect an assistant
Every assistant connects to the same endpoint. Claude and ChatGPT sign in with OAuth; Cursor, Grok Bot and other header-based clients use an API token.
Before you start
- Be an owner or admin of the Leitvik workspace you want to connect.
- Use this endpoint:
https://app.leitvik.com/api/mcp - Decide what the assistant may change. Start with read scopes and add writes later.
Claude
OAuthLive verification pending
Custom connector with OAuth.
- In Claude, add a custom connector with the URL
https://app.leitvik.com/api/mcp. Leave the client ID and secret empty. - Claude opens Leitvik in your browser. Sign in if asked: authorizing needs a sign-in from the last ten minutes.
- Choose the workspace and what Claude may do there. Reads are preselected; turn on only the writes it needs.
- Ask Claude to call
leitvik_contextand check the workspace name.
ChatGPT
OAuthLive verification pending
Connector in developer mode, with OAuth.
- In ChatGPT, with developer mode on, create a connector with the URL
https://app.leitvik.com/api/mcpand OAuth authentication. Leave the client ID and secret empty. - ChatGPT opens Leitvik in your browser. Sign in if asked.
- Choose the workspace and the scopes, then confirm.
- Ask ChatGPT to call
leitvik_contextand check the workspace name.
Cursor
API tokenLive verification pending
MCP configuration with a Bearer token header.
- Create an API token in Settings > API tokens with the scopes Cursor needs.
- Set two environment variables where Cursor runs:
LEITVIK_URLwithhttps://app.leitvik.com(no trailing slash) andLEITVIK_TOKENwith the token. - Merge this server into your
.cursor/mcp.jsonor user MCP configuration, keeping any other servers. - Ask the agent to call
leitvik_context.
{
"mcpServers": {
"leitvik": {
"url": "${env:LEITVIK_URL}/api/mcp",
"headers": { "Authorization": "Bearer ${env:LEITVIK_TOKEN}" }
}
}
}Cursor expands ${env:…} from the environment of the running client. A remote server cannot use the stdio-only envFile option.
Grok Bot
API tokenLive verification pending
Custom MCP server added from the chat, with a Bearer token header.
- Create an API token in Settings > API tokens. For daily work choose the read scopes plus
tasks:write,opportunities:writeandcaptures:write. - In a Grok Bot chat, ask: "Add a custom MCP server called leitvik at
https://app.leitvik.com/api/mcp". - When it asks for authentication, give the header name
Authorizationand the valueBearer qre_…with your token. Do not paste the token anywhere else in the conversation. - Ask Grok to call
leitvik_contextand confirm the workspace. Keep per-tool approval on for writes until you have seen how it behaves.
Grok Bot runs on a cloud computer, so it needs the public HTTPS endpoint. The header step comes from a third-party walkthrough; we have not found an official xAI page for it.
Other MCP clients
Live verification pending
Any client that supports remote servers over Streamable HTTP.
- URL
https://app.leitvik.com/api/mcp- Transport
- Streamable HTTP (stateless, JSON responses)
- Authentication
- OAuth 2.1 with discovery, or the header
Authorization: Bearer qre_…
After connecting
- Check the workspace with
leitvik_contextbefore working with CRM data. - Use one credential per assistant, so you can revoke each on its own.
- To disconnect, revoke the token or the connected application in Settings > API tokens.