MCP setup guide

Connect your AI assistant
to Ethira

Bring your risk register, vendor portfolio, inventory, and compliance data into the AI tools your team already uses — Cursor, Claude, ChatGPT, VS Code, or any Model Context Protocol client. Once connected, just ask.

List my critical vendorsWhat risks are overdue?Which processing activities are missing a lawful basis?

Takes about 60 seconds · Uses your existing login · Scoped to your own permissions

Before you start

What you'll need

An Ethira account with access to a workspace
One of: Cursor, Claude (web or desktop), ChatGPT (Pro / Team / Enterprise), VS Code, or another MCP-compatible client
About 60 seconds

Everything your assistant can see or do is scoped to your own permissions in the workspace. It can never access data you can't access yourself.

Before you start

Choose your path

There are two ways to connect, depending on your tool. Both take about a minute — pick the one that matches your assistant.

Option A

Cursor, VS Code & token clients

Generate a token, drop it into your tool, test, and go. The quickest route for developer tools.

Jump to Option A →

Option B

Claude & ChatGPT

Connect with a secure sign-in — nothing to paste but a name and a URL. No token to manage.

Jump to Option B →

Connect · Option A

Cursor, VS Code, or any token-based client

The fastest route: generate a token in Ethira, add it to your tool, and confirm it's live.

Open the MCP Server page
In Ethira, open the MCP Server page from the workspace menu.
Generate your token
Click Generate MCP token, then Copy token. Save it somewhere safe — it's shown only once, and you can generate a new one anytime.
Add it to your tool
Under Add to your AI tool, pick your client:
- Cursor — click Add to Cursor. It opens and wires up the connection automatically.
- VS Code — click Add to VS Code (or Insiders). VS Code prompts you to install.
- Any other client — open the Manual tab for the endpoint, header, and a ready-to-run curl example.
Test the connection
Click Test connection. A green checkmark and a tool count means you're live. This one click catches typos, revoked tokens, and corporate-firewall issues in a second.
Start asking
Open your tool and ask a real question — for example, "What are my top 5 risks right now?"

Connect · Option B

Claude or ChatGPT

Claude and ChatGPT connect via a secure sign-in (OAuth) — there's nothing to paste except a name and a URL.

Open the MCP Server page
In Ethira, open the MCP Server page from the workspace menu, then open the Claude (or ChatGPT) tab.
Open the connector dialog
Click Open Claude connectors (or Open ChatGPT connectors). Your assistant opens its "Add custom connector" screen in a new tab.
Paste the two values
Copy the Name and URL shown on the Ethira page into the matching fields:
- Name — Ethira
- URL — https://api.ethira.dev/v1/mcp
Sign in and approve
Click Add. You'll be sent to Ethira to sign in — the same login as the app, including SSO. Confirm the workspace you have selected and click Approve.
Start asking
The connector shows as Connected. Ask anything, or run a deep research task — your assistant searches across your risks, systems, documents, and vendors.

Run it well

Managing access & staying secure

A connection is only ever as powerful as your own account — and you stay in control of it from start to finish.

Permissions mirror yoursA connection inherits exactly your scope at the time you create it. Adjust it by scoping the key in the API Keys drawer, or through your workspace Roles.
Disconnect anytimeFor a token client, disable its key in the API Keys drawer and it stops working on the next request. For Claude or ChatGPT, remove the Ethira connector from your assistant's own connector settings.
One tool, one connectionUse a separate token or connector per client, so disconnecting one never breaks another.
Rotate periodicallyRefresh your MCP tokens periodically to keep access tidy.
Logged for adminsCreating and disabling MCP tokens is recorded in your workspace activity log, so admins can see who connected what.

Run it well

Troubleshooting

? "Connection failed" on Test connection

The page shows the exact error. A blocked network usually means your firewall needs to allow api.ethira.dev.

? Your assistant says it can't find something

The token likely inherits a narrower scope than expected. Check the tool list on the MCP Server page, or ask an admin to widen your permission group, then generate a fresh token.

? Wrong workspace connected (Claude / ChatGPT)

Remove the Ethira connector in Claude or ChatGPT, select the correct workspace in Ethira's workspace switcher, then reconnect and approve.

That's it — you're connected

Your risks, vendors, inventory, and compliance data are now a question away, right inside the tools you already use. Ask away.

Book a demo Back to top ↑

MCP setup guide

Connect your AI assistant
to Ethira

List my critical vendorsWhat risks are overdue?Which processing activities are missing a lawful basis?

Takes about 60 seconds · Uses your existing login · Scoped to your own permissions

Before you start

What you'll need

An Ethira account with access to a workspace
One of: Cursor, Claude (web or desktop), ChatGPT (Pro / Team / Enterprise), VS Code, or another MCP-compatible client
About 60 seconds

Everything your assistant can see or do is scoped to your own permissions in the workspace. It can never access data you can't access yourself.

Before you start

Choose your path

There are two ways to connect, depending on your tool. Both take about a minute — pick the one that matches your assistant.

Option A

Cursor, VS Code & token clients

Generate a token, drop it into your tool, test, and go. The quickest route for developer tools.

Jump to Option A →

Option B

Claude & ChatGPT

Connect with a secure sign-in — nothing to paste but a name and a URL. No token to manage.

Jump to Option B →

Connect · Option A

Cursor, VS Code, or any token-based client

The fastest route: generate a token in Ethira, add it to your tool, and confirm it's live.

Open the MCP Server page
In Ethira, open the MCP Server page from the workspace menu.
Generate your token
Click Generate MCP token, then Copy token. Save it somewhere safe — it's shown only once, and you can generate a new one anytime.
Add it to your tool
Under Add to your AI tool, pick your client:
- Cursor — click Add to Cursor. It opens and wires up the connection automatically.
- VS Code — click Add to VS Code (or Insiders). VS Code prompts you to install.
- Any other client — open the Manual tab for the endpoint, header, and a ready-to-run curl example.
Test the connection
Click Test connection. A green checkmark and a tool count means you're live. This one click catches typos, revoked tokens, and corporate-firewall issues in a second.
Start asking
Open your tool and ask a real question — for example, "What are my top 5 risks right now?"

Connect · Option B

Claude or ChatGPT

Claude and ChatGPT connect via a secure sign-in (OAuth) — there's nothing to paste except a name and a URL.

Open the MCP Server page
In Ethira, open the MCP Server page from the workspace menu, then open the Claude (or ChatGPT) tab.
Open the connector dialog
Click Open Claude connectors (or Open ChatGPT connectors). Your assistant opens its "Add custom connector" screen in a new tab.
Paste the two values
Copy the Name and URL shown on the Ethira page into the matching fields:
- Name — Ethira
- URL — https://api.ethira.dev/v1/mcp
Sign in and approve
Click Add. You'll be sent to Ethira to sign in — the same login as the app, including SSO. Confirm the workspace you have selected and click Approve.
Start asking
The connector shows as Connected. Ask anything, or run a deep research task — your assistant searches across your risks, systems, documents, and vendors.

Run it well

Managing access & staying secure

A connection is only ever as powerful as your own account — and you stay in control of it from start to finish.

Permissions mirror yoursA connection inherits exactly your scope at the time you create it. Adjust it by scoping the key in the API Keys drawer, or through your workspace Roles.
Disconnect anytimeFor a token client, disable its key in the API Keys drawer and it stops working on the next request. For Claude or ChatGPT, remove the Ethira connector from your assistant's own connector settings.
One tool, one connectionUse a separate token or connector per client, so disconnecting one never breaks another.
Rotate periodicallyRefresh your MCP tokens periodically to keep access tidy.
Logged for adminsCreating and disabling MCP tokens is recorded in your workspace activity log, so admins can see who connected what.

Run it well

Troubleshooting

? "Connection failed" on Test connection

The page shows the exact error. A blocked network usually means your firewall needs to allow api.ethira.dev.

? Your assistant says it can't find something

The token likely inherits a narrower scope than expected. Check the tool list on the MCP Server page, or ask an admin to widen your permission group, then generate a fresh token.

? Wrong workspace connected (Claude / ChatGPT)

Remove the Ethira connector in Claude or ChatGPT, select the correct workspace in Ethira's workspace switcher, then reconnect and approve.

That's it — you're connected

Your risks, vendors, inventory, and compliance data are now a question away, right inside the tools you already use. Ask away.

Book a demo Back to top ↑