Skip to main content

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:

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, you may be unable to create or use a DoiT API key with the MCP server, or requests may fail with 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 DoiT API key authenticates requests. In addition, each DoiT API operation enforces its own permissions.

Prerequisites​

  • You must have a valid DoiT API key. Remote connectors prompt you for the key during setup. Local stdio clients store the key in their configuration.

  • 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 two connection methods depending on your client: remote (SSE) or local (stdio).

  • Remote (SSE): Your client connects over HTTPS to https://mcp.doit.com/sse (Server-Sent Events). Each time the connection is established or a request is made, the connector automatically verifies your credentials to ensure a secure data stream.

  • 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.

    • a DOIT_API_KEY environment variable.

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.

Last updated on