> ## 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 ChatGPT to the Didit MCP Server

> Use Didit in ChatGPT: install the Didit plugin from the ChatGPT directory, or add mcp.didit.me/mcp as a custom MCP server. Sign in with Didit, no API key.

Didit works in ChatGPT two ways: install the **Didit plugin** from the ChatGPT plugin directory, or add the hosted Didit MCP server (`https://mcp.didit.me/mcp`) as a **custom MCP server**. Both sign you in with your Didit account over OAuth, so there is no API key to copy.

> [card] [Install the Didit plugin](https://chatgpt.com/plugins/plugin_asdk_app_6a432adffe488191bae655d50a6a0d4c)
>
> Opens the Didit listing in ChatGPT's plugin directory. Click **Install plugin**, then sign in with Didit.

> [card] [Add the full MCP server](#add-didit-as-a-custom-mcp-server)
>
> Every Didit tool your role allows, added by URL as a custom MCP server.

***

## Which one to use

| | Didit plugin (directory) | Custom MCP server |
| - | - | - |
| How you add it | **Plugins**, search "Didit", **Install plugin** | **Plugins → Add → Add custom MCP server**, URL `https://mcp.didit.me/mcp` |
| Reviewed by OpenAI | Yes, published by Didit Identity, Inc. | No, you add it yourself |
| What it can do | Verification links, sessions and their status, workflows and questionnaires, case and report status, webhook destinations, aggregate analytics | The same hosted server and tool catalog as [Claude](https://docs.didit.me/integration/mcp/claude.md), limited by your console role |
| What it leaves out | Document and face uploads, government ID number inputs, one-time codes, raw API keys, payment checkout. Identity evidence, images, private notes and report contents stay out of its answers | Only what your role does not allow, plus what the hosted server keeps out of every connector |
| Best for | Operations and support teams in ChatGPT | Developers and compliance leads who want the full toolset |

Both act as **you**: only in the organizations you approve at sign-in, and only with your role's permissions.

***

## Install the Didit plugin

1. In ChatGPT, open **Plugins** in the sidebar and search for **Didit**, or open the [Didit listing](https://chatgpt.com/plugins/plugin_asdk_app_6a432adffe488191bae655d50a6a0d4c) directly. The listing shows **By Didit Identity, Inc.** in the **Business & Operations** category.
2. Click **Install plugin**.
3. ChatGPT opens **Log in with Didit**. Pick the organizations ChatGPT may use, review the permissions, and click **Approve**.

Try it with one of the listing's own prompts:

* "Create a verification link I can send to a new customer."
* "Summarize my verification sessions from the last 30 days by status."
* "Show my verification workflows and explain their configured steps."

Customers complete the identity check on Didit's hosted verification page; ChatGPT only sees the link, statuses, dates and counts.

***

## Add Didit as a custom MCP server

Use this path when you want the full Didit toolset in ChatGPT: building workflows, AML screening, transaction monitoring, lists and the rest of the [tools reference](https://docs.didit.me/integration/mcp/tools.md).

**1. Open the custom server dialog**

In ChatGPT, open **Plugins**, click **Add**, and choose **Add custom MCP server**.

If **Add custom MCP server** is missing, your plan or workspace does not allow custom MCP servers yet. On a Business or Enterprise workspace, ask an admin to enable them.

**2. Fill in the server**

* **Name**: `Didit MCP`. ChatGPT refuses a name an existing app already uses, and the directory plugin is called `Didit`.
* **Description** (optional): `Identity verification, KYB, AML screening and fraud checks`
* **Connection**: **Server URL**, then paste:

```text theme={null}
https://mcp.didit.me/mcp
```

* **Authentication**: **OAuth**.

ChatGPT reads the OAuth settings from the server by itself. Under **Advanced OAuth settings** you will see the Didit authorization endpoints and the Didit scopes, such as `didit:management` and `didit:verification`, already filled in. Leave them as they are.

**3. Create and connect**

Tick **I understand and want to continue**, click **Create as a plugin**, then **Connect Didit MCP**.

**4. Log in with Didit**

ChatGPT sends you to **Log in with Didit**. Choose the organizations to connect, review what ChatGPT will be allowed to do, and click **Approve**. You land back in ChatGPT with **Didit MCP** listed under **Installed**.

> [!NOTE]
>
> **No API key anywhere.** The server uses OAuth 2.1 with PKCE. ChatGPT identifies itself with a Client ID Metadata Document, so there is no client ID or secret to paste. See [Authentication](https://docs.didit.me/integration/mcp/authentication.md).

***

## Check that it works

Start a chat and ask:

```text theme={null}
Use the Didit MCP app: call didit_context_get and list my Didit organizations and their applications. Read-only, do not change anything.
```

ChatGPT calls `didit_context_get` and answers with each organization you approved, its applications, and whether each one is live or sandbox. If it says it has no Didit tools, the sign-in did not finish: open **Plugins**, select **Didit MCP** under **Installed**, and connect again.

Then try real work:

* "Create a KYC workflow with ID verification, passive liveness and AML screening, then give me a verification link."
* "Which sessions are waiting in my review queue, and why was each one flagged?"
* "Screen this wallet for AML risk and add it to the blocklist if it hits."

ChatGPT asks you to confirm before a tool changes anything. Keep that on for write and delete actions.

***

## Troubleshooting

* **"An app with this name already exists."** Pick another name, for example `Didit MCP`.
* **Sign-in loops or fails.** Log in at [business.didit.me](https://business.didit.me) in the same browser first, then click **Connect** again.
* **A tool answers with `missing_scope`.** Your role in that organization lacks the permission. Ask an owner or admin. See [roles and permissions](https://docs.didit.me/integration/mcp/authentication.md#roles-and-permissions).
* **You approved the wrong organizations.** Sign in at [business.didit.me](https://business.didit.me), open **Account settings → Connected apps**, revoke ChatGPT, then connect again and pick the right ones.

***

## Next steps

> [card] [Connect Claude](https://docs.didit.me/integration/mcp/claude.md)
>
> One-click connector link for Claude web, Desktop and Code.

> [card] [Connect Cursor](https://docs.didit.me/integration/mcp/cursor.md)
>
> One-click install link and mcp.json for Cursor.

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

> [card] [Example prompts](https://docs.didit.me/integration/mcp/examples.md)
>
> Longer worked examples with real payloads.


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