Connect a client

Every client uses the same server URL:

https://app.docutray.com/api/mcp

The first time a client calls a tool, it opens the DocuTray sign-in page. The flow is the same everywhere:

1. Sign in with your DocuTray account (email and password, Google, or your two-factor method if you enabled it).
2. Pick the organization the client will work with. If you belong to only one, it is preselected.
3. Review the permissions the client asks for and click Allow. See Scopes for what each one grants.

The client then receives a short-lived access token for that organization and renews it on its own. You can revoke it at any time from Connected apps.

Claude (web, desktop and mobile)

1. Open Settings → Connectors in claude.ai or Claude Desktop.
2. Click Add custom connector.
3. Enter DocuTray as the name and https://app.docutray.com/api/mcp as the URL, then click Add.
4. Click Connect next to DocuTray and complete the sign-in.
5. In a conversation, enable DocuTray from the tools menu.

On Team and Enterprise plans an owner may need to add the connector for the organization first. Connectors added on the web are also available in Claude Desktop and the mobile apps.

Claude Code

claude mcp add --transport http docutray https://app.docutray.com/api/mcp

Add --scope user to make the server available in every project, or --scope project to share it with your team through .mcp.json:

{
  "mcpServers": {
    "docutray": {
      "type": "http",
      "url": "https://app.docutray.com/api/mcp"
    }
  }
}

Then run /mcp, select docutray and choose Authenticate. Claude Code opens the browser and listens on a local port for the result.

ChatGPT

1. Open Settings in chatgpt.com and go to the plugins (formerly Apps & Connectors) section.
2. If DocuTray is not listed in the directory yet, open Advanced settings and turn on Developer mode.
3. Click Create (or Add custom plugin), enter DocuTray as the name and https://app.docutray.com/api/mcp as the URL, and choose OAuth as the authentication method.
4. Complete the sign-in, then enable DocuTray from the composer's tools menu.

Developer mode availability depends on your ChatGPT plan and, on Business, Enterprise and Edu workspaces, on your admin's settings.

Cursor

Click the button to install the server:

Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "docutray": {
      "url": "https://app.docutray.com/api/mcp"
    }
  }
}

Open Cursor Settings → MCP, find DocuTray and click Login (or Needs login) to complete the sign-in.

VS Code (GitHub Copilot)

From a terminal:

code --add-mcp '{"name":"docutray","type":"http","url":"https://app.docutray.com/api/mcp"}'

Or add it to .vscode/mcp.json in your workspace (or run MCP: Add Server from the Command Palette):

{
  "servers": {
    "docutray": {
      "type": "http",
      "url": "https://app.docutray.com/api/mcp"
    }
  }
}

Click Start above the server entry, accept the authentication prompt and complete the sign-in. The DocuTray tools then appear in Copilot Chat's Agent mode tool picker.

Copilot Studio

1. Open your agent and go to Tools → Add a tool → New tool → Model Context Protocol.
2. Fill in:
   • Server name: DocuTray
   • Server description: Extract structured data from documents with DocuTray.
   • Server URL: https://app.docutray.com/api/mcp
3. Under Authentication, choose OAuth 2.0 → Dynamic discovery.
4. Click Create, then create a new connection and complete the sign-in.

If your tenant requires a pre-registered OAuth application (Manual OAuth), contact support@docutray.com with the redirect URL that Copilot Studio shows. We issue a client ID and secret for your tenant.

Other clients

Any client that implements the MCP authorization spec over Streamable HTTP can connect. The server supports the 2025-06-18, 2025-11-25 and 2026-07-28 protocol versions, and earlier ones. Clients discover the authorization server from the WWW-Authenticate header of the first 401 response, which points to:

https://app.docutray.com/.well-known/oauth-protected-resource/api/mcp

API keys are not accepted on the MCP endpoint. To call DocuTray with an API key, use the REST API, the SDKs or the CLI.

Troubleshooting