Connections

You can connect to the DoiT MCP server using any client that supports the MCP protocol. The following sections explain how to connect the following AI tools:

• ChatGPT

• Codex

• Claude

• Cursor

• Gemini CLI

• VS Code

Required permissions

• To connect and access DoiT Cloud Intelligence via the MCP server, your user must be assigned the Billing Profiles Admin permission.

• Your DoiT plan must include access to the DoiT API. Without that access, authorization may fail or requests may return authorization errors. If you're unsure whether your plan includes access to the DoiT API, contact your DoiT account manager or review your DoiT Cloud Intelligence plan.

• The DoiT MCP server tools map to the DoiT Cloud Intelligence API. Your signed-in DoiT account authenticates requests. In addition, each DoiT API operation enforces its own permissions.

Prerequisites

• A supported web browser to complete the DoiT sign-in flow when you connect.

• For local connections, Node.js must be on your machine so npx can run @doitintl/doit-mcp-server. This does not apply to remote connections.

Connection types

The DoiT MCP server supports remote or local (stdio) connections depending on your client.

• Remote (Streamable HTTP): Your client connects over HTTPS to https://mcp.doit.com/mcp. When you connect, your browser opens a DoiT sign-in page. Sign in with your DoiT account and select Allow access on the DoiT consent screen.

• Remote (SSE, legacy): The endpoint https://mcp.doit.com/sse remains available for existing connectors that were configured before the Streamable HTTP endpoint.

• Local (stdio): Your client launches the published package on your machine using standard input/output (stdio). Typically, the setup requires:

  • Node.js is on your PATH so npx can run @doitintl/doit-mcp-server@latest.

  • An mcp.json or equivalent configuration entry with no API keys. When the client starts the server, your browser opens the same DoiT sign-in and consent flow.

Use your AI tool for connection

If you prefer, you can ask your AI tool to help connect to the DoiT MCP server directly in your local environment.

Example prompt: Here is the GitHub repo: https://github.com/doitintl/doit-mcp-server. Can you explain how to connect to the DoiT MCP server from my setup and walk me through it step by step? I'm using <tool name>, <OS>, and <shell>. If any command fails, help me troubleshoot and continue.