> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Cursor to the Didit MCP Server

> Add the Didit MCP server to Cursor with a one-click install link or a three-line mcp.json, then sign in with Didit. No API key, works in Cursor's agent.

Cursor connects to the hosted Didit MCP server (`https://mcp.didit.me/mcp`) with one install link or three lines of `mcp.json`. On first use Cursor opens **Log in with Didit** in your browser; there is no API key to copy.

> [card] [Add Didit to Cursor](https://cursor.com/install-mcp?name=didit\&config=eyJ1cmwiOiJodHRwczovL21jcC5kaWRpdC5tZS9tY3AifQ%3D%3D)
>
> Opens Cursor's install page, which launches Cursor and adds the server `didit` with URL mcp.didit.me/mcp. Confirm the install, then sign in with Didit.

The install link, if you want to put it behind your own button or in a README:

```text theme={null}
https://cursor.com/install-mcp?name=didit&config=eyJ1cmwiOiJodHRwczovL21jcC5kaWRpdC5tZS9tY3AifQ%3D%3D
```

It wraps Cursor's deeplink, which you can also use directly:

```text theme={null}
cursor://anysphere.cursor-deeplink/mcp/install?name=didit&config=eyJ1cmwiOiJodHRwczovL21jcC5kaWRpdC5tZS9tY3AifQ==
```

The `config` value is the base64 of `{"url":"https://mcp.didit.me/mcp"}`.

***

## Set up by method

> [tab] Install link
>
> 1. Click [**Add Didit to Cursor →**](https://cursor.com/install-mcp?name=didit\&config=eyJ1cmwiOiJodHRwczovL21jcC5kaWRpdC5tZS9tY3AifQ%3D%3D). Your browser asks to open Cursor; allow it.
> 2. Cursor shows the server `didit` with URL `https://mcp.didit.me/mcp`. Confirm the install.
> 3. When Cursor lists `didit` as needing sign-in, click to connect and complete **Log in with Didit** in the browser.
>
> If Cursor does not open, the install page prints the configuration for you to paste into `mcp.json` by hand.

> [tab] mcp.json
>
> Add Didit to `~/.cursor/mcp.json` (every project) or `.cursor/mcp.json` (one project):
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "didit": {
>       "url": "https://mcp.didit.me/mcp"
>     }
>   }
> }
> ```
>
> Keep any servers you already have inside `mcpServers`. On first use Cursor registers itself with Didit automatically and opens the browser for **Log in with Didit**.

> [tab] Command line
>
> The `cursor` command can add the server to your user profile:
>
> ```bash theme={null}
> cursor --add-mcp '{"name":"didit","type":"http","url":"https://mcp.didit.me/mcp"}'
> ```
>
> It prints `Added MCP servers: didit`. Open Cursor and sign in when it asks.

> [!NOTE]
>
> **No API key in the config.** The server uses OAuth 2.1 with PKCE and acts as **you**: only in the organizations you approve at sign-in, with your role's permissions. See [Authentication](https://docs.didit.me/integration/mcp/authentication.md).

***

## Check that it works

In Cursor's agent chat, ask:

```text theme={null}
Use the Didit MCP server to call didit_context_get and list my organizations and applications.
```

The agent calls `didit_context_get` and lists your organizations with their applications. Then put it to work on your codebase:

* "Create a sandbox KYC workflow with ID verification and liveness, then add the Didit web SDK to this app using that workflow."
* "Register a webhook destination for session status updates pointing at my `/api/didit/webhook` route, and write the handler that verifies the signature."
* "Create a test session for `user_123` and give me the verification link."

***

## Troubleshooting

* **Cursor did not open from the link.** Paste the JSON from the **mcp.json** tab instead.
* **Sign-in loops or fails.** Log in at [business.didit.me](https://business.didit.me) in your default browser first, then connect again.
* **A tool answers with `missing_scope`.** Your role in that organization lacks the permission. See [roles and permissions](https://docs.didit.me/integration/mcp/authentication.md#roles-and-permissions).
* **The agent says it has no Didit tools.** Check that the `didit` server is enabled in Cursor's MCP settings and finished sign-in. See [Troubleshooting](https://docs.didit.me/integration/mcp/advanced.md#troubleshooting).

***

## Next steps

> [card] [Connect VS Code](https://docs.didit.me/integration/mcp/vscode.md)
>
> Install link and mcp.json for GitHub Copilot in VS Code.

> [card] [Connect OpenAI Codex](https://docs.didit.me/integration/mcp/codex.md)
>
> One command for the Codex CLI and IDE extension.

> [card] [Tools reference](https://docs.didit.me/integration/mcp/tools.md)
>
> Everything the agent can call, tool by tool.

> [card] [Single-prompt integration](https://docs.didit.me/integration/mcp/examples.md)
>
> Worked examples of an agent building a Didit integration.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.