Server URL
Use the URL of your data region:Add it to your AI tool
Add the server URL as a custom connector (or MCP server) in your AI tool, then sign in with Gleap when it asks. The sign-in opens Gleap in your browser, where you pick the projects the agent may use. Claude, ChatGPT and other chat apps: add a custom connector with the server URL. Claude Code and Codex: add the server (US workspaces use the US URL), then sign in: in Claude Code with/mcp and Authenticate, in Codex with codex mcp login gleap. For working Gleap tickets in your repository, the Gleap plugin sets this up for you: see Coding agents.
.cursor/mcp.json, then sign in when Cursor asks.
x-gleap-api-key (an Admin API key) and x-gleap-project-id instead. That connects one project.
Choose your projects
One connection can cover up to 10 projects, from any workspace you belong to. When you sign in, tick the projects the agent may use. Projects whose plan doesn’t include the Gleap MCP are shown locked. One of them is the main project: the topmost ticked one, or the one you pick by hovering a project and clicking Make main. With several projects:- Every tool takes an optional
projectId, andlist_projectslists the projects with their ids. - Tools that only read use the main project when the agent names none, and each answer says which project it came from.
- Tools that change something always need
projectId. Without it, the agent asks you which project you mean.
Access
- The agent has your role in each project. If your role changes, the agent’s role changes with it.
- If you leave a project, it drops out of the connection within the hour; the other projects keep working. If you leave all of them, the connection ends.
- To disconnect, remove the connector in your AI tool.