Connect your agent
Last updated:
Read as MarkdownConnect your harness to Ekaya once, then ask.
Open a Project
Use Try it free in the navigation to create your account in the Cloud console; it then opens the Projects page. If you already have an account, sign in there. A person creates the Project in the console; an MCP tool does not create it.
Follow the Getting Started recipe for the walkthrough. Open the Project's Setup screen and use its instructions for your client.
Connect Claude Code
Copy the Project's MCP URL from Setup. The Cloud URL has this shape:
https://<region>.ekaya.ai/mcp/<projectId>
Use the URL from the Project, including its Region and Project identifier. There is no global MCP endpoint.
claude mcp add --transport http ekaya <the Project's MCP URL>
Replace the placeholder with the Project's MCP URL before running the command. Keep --transport http. Then open Claude Code, use /mcp, select ekaya, and complete the browser sign-in.
Also works with Codex, Cursor, Claude Desktop, VS Code, and GitHub Copilot.
Other clients use their own setup instructions on the Project's Setup screen. The command above configures Claude Code.
Check the connection
Ask your agent to describe the Project and the work you want to do. The tools it can discover depend on the caller's access and the Project's configuration. Use that live tool list when choosing the next operation.
An unattended process uses a Data Access Point with its own grants. A teammate opening a Hosted Application uses a browser and does not need an MCP connection.