iyedy docs, home
FR Lire en françaisOpen iyedy (opens in a new tab)

Connect iyedy to Claude

Work with your architecture diagrams in a Claude conversation. Claude reads your models, runs iyedy's checks and prepares changes. It never edits a model itself; you, or someone who can edit the diagram, apply each change in iyedy.

On this page
Guide · 5 minAll plansUpdated 30 Oct 2026
iyedy is in the Claude directory

claude.ai, Claude Desktop, the Claude mobile apps and Claude Code connect to iyedy. In claude.ai and Claude Desktop, add it from the Claude directory: claude.ai/directory/iyedy. The directory shows it with the Community label: it was screened before it was listed but not reviewed in depth, and Claude reminds you of that before you connect. You can still add iyedy by its address, as a custom connector.

Before you start

  • An iyedy account. Sign in once at app.iyedy.com with the identity you will use in Claude, and finish creating your account. Claude sees exactly the diagrams this account can read.
  • A Claude account and the Claude app you use: claude.ai in your browser, Claude Desktop or the Claude mobile apps. For the Claude Code tab: Claude Code on your computer, signed in to your Claude account.
  • On a Claude Team or Enterprise plan, an Owner of your Claude organisation adds the connector for everyone, then each member connects with their own account. See Claude Team and Enterprise.
  • In an iyedy organisation (Team, Enterprise), access for Claude is off until an owner asks support@iyedy.com to turn it on. Your personal workspace works right away.

Set up

Choose the Claude app you use. Your choice is kept for the other pages.

  1. Add iyedy to Claude Code

    Run this once in your terminal. --scope user makes iyedy available in all your projects. --client-id claude-code tells iyedy the sign-in comes from Claude Code.

    Terminal
    $ claude mcp add --transport http --scope user \
    --client-id claude-code iyedy https://app.iyedy.com/mcp$ claude mcp add \
    --transport http \
    --scope user \
    --client-id claude-code \
    iyedy \
    https://app.iyedy.com/mcp

    Coming soonSimpler sign-in for Claude Code.

  2. Sign in to iyedy

    In a Claude Code session, run /mcp, select iyedy, then Authenticate. You can also run this in your terminal:

    Terminal
    $ claude mcp login iyedy

    Your browser opens the iyedy sign-in page.

  3. Approve the access

    Check that the page is on auth.iyedy.com, read what Claude Code asks for, then select Allow.

    On auth.iyedy.com · the access page

    The iyedy access page in the browser: the address bar shows auth.iyedy.com, the card lists three permissions and ends with Deny and Allow.

    1. The address is auth.iyedy.com. Claude never sees your password.
    2. What Claude Code will be able to do. Nothing here edits, deletes or shares a diagram.
    3. Allow sends you back to Claude Code, which keeps the sign-in for you.
  4. Ask Claude

    Back in Claude Code, try: “List my iyedy diagrams and explain how the claims platform is built.”

    You are done when Claude answers with the names of your own diagrams.
On a machine without a browser

Run this command and open the address it prints on another device.

Terminal
$ claude mcp login iyedy --no-browser$ claude mcp login iyedy \
    --no-browser
  1. Find iyedy in the directory

    Open claude.ai/directory/iyedy. Or, in claude.ai, go to Customize › Connectors, select Discover and enter iyedy in Search connectors, then open iyedy.

  2. Connect

    Select Connect to Claude.

    On a Claude Team or Enterprise plan, an Owner sees Connect for your team, which adds iyedy for everyone, then connects their own account. A member sees Connect to Claude once iyedy is added for the organisation, or, until then, Request or a note to ask an Owner. See Claude Team and Enterprise.

  3. Sign in and approve

    Sign in on auth.iyedy.com as you do in the app: e-mail and password, Google, or your organisation's single sign-on. Read what Claude asks for, then select Allow. You are back in claude.ai, with iyedy connected.

  4. Ask Claude

    In a conversation, select + › Connectors and turn on iyedy. Then ask, for example:

    “List my iyedy diagrams.”“What breaks in Claims Platform if the claims database fails?”“Run the checks on Claims Platform and summarise the findings.”

    By default, Claude asks for your approval before it uses a tool that stores something, such as submitting a proposal, unless you chose Always allow for that tool.

    You are done when Claude answers with the names of your own diagrams.
  1. Find iyedy in the directory

    In Claude Desktop, select Customize in the sidebar, then Connectors. Select Discover, enter iyedy in Search connectors, then open iyedy.

  2. Connect

    Select Connect to Claude.

    On a Claude Team or Enterprise plan, an Owner sees Connect for your team, which adds iyedy for everyone, then connects their own account. A member sees Connect to Claude once iyedy is added for the organisation, or, until then, Request or a note to ask an Owner. See Claude Team and Enterprise.

  3. Sign in and approve

    Sign in on auth.iyedy.com as you do in the app, read what Claude asks for, then select Allow. If the sign-in opened in your browser, go back to Claude Desktop: iyedy is connected.

  4. Ask Claude

    In a conversation, select + › Connectors and turn on iyedy. Then ask, for example:

    “List my iyedy diagrams.”“What breaks in Claims Platform if the claims database fails?”“Run the checks on Claims Platform and summarise the findings.”

    By default, Claude asks for your approval before it uses a tool that stores something, such as submitting a proposal, unless you chose Always allow for that tool.

    You are done when Claude answers with the names of your own diagrams.
  1. Add iyedy on the web or in Claude Desktop

    The Claude mobile apps use the connectors of your Claude account. Add iyedy once from the directory in claude.ai or in Claude Desktop (the claude.ai and Desktop tabs), signed in with the same Claude account as on your phone.

  2. Turn it on in a conversation

    In the mobile app, open a conversation, select + › Connectors and turn on iyedy. Then ask, for example: “List my iyedy diagrams.”

    You are done when Claude answers with the names of your own diagrams.

Add iyedy by its address

If you prefer, add iyedy as a custom connector. In claude.ai or Claude Desktop, go to Customize › Connectors and select Add custom connector (if you see + Add first, select it, then Add custom connector). Name the connector iyedy and enter this address:

https://app.iyedy.com/mcp

Leave Advanced settings empty: iyedy needs no client ID and no secret. If Claude shows the settings it detected after Continue, keep them: Sign in now and Use Claude's published identity. Select Add. If the sign-in does not open by itself, select Connect next to iyedy. Sign in on auth.iyedy.com, read what Claude asks for, then select Allow. On the Free plan, Claude lets you add one custom connector.

On a Claude Team or Enterprise plan, only an Owner adds a custom connector: see Claude Team and Enterprise. If your Owner already added it, find iyedy under Customize › Connectors with the Custom label and select Connect.

What Claude can do

Claude picks the tools from your request. Reading tools never change anything. The two tools that store something ask for your approval by default.

Read and analyse

Diagrams, views, versions, findings, dependencies across diagrams.

22 read-only tools

Propose a change

Preview a change, then submit it as a proposal that a person reviews in iyedy.

2 tools that write · approval by default
Only a person changes a model

A proposal from Claude waits in iyedy, labelled Claude or Claude Code, until someone who can edit the diagram applies or rejects it. A proposal nobody handles is deleted 30 days after it was made.

Privacy

  • What Claude can read. Only the diagrams your iyedy account can open, up to a ceiling: Confidential on personal workspaces, Internal on Team and Enterprise. Restricted diagrams are never sent. Values that look like secrets are replaced before they leave iyedy.
  • What Claude can change. Nothing directly. Claude can submit a proposal or withdraw its own, and you, or someone who can edit the diagram, apply it in iyedy.
  • Your data. iyedy does not use your diagrams to train AI models. What Claude does with what it reads is covered by your Claude account terms. Inside iyedy, the Assistant uses our AI model provider, which processes data worldwide and deletes it within 30 days.

Full details: Privacy policy.

Disconnect

In claude.ai or Claude Desktop, go to Customize › Connectors and select iyedy. Select Disconnect to sign Claude out, or open the three-dot menu and select Remove to take iyedy off your account. The mobile apps follow, since they use the same connectors.

To make Claude Code forget the sign-in, run:

Terminal
$ claude mcp logout iyedy

To remove iyedy from Claude Code:

Terminal
$ claude mcp remove iyedy

There is no screen in iyedy for this yet. To remove the access on iyedy's side, write to support@iyedy.com.

Troubleshooting

Claude asks you to sign in to iyedy again

The sign-in did not finish or has expired. In claude.ai or Claude Desktop, go to Customize › Connectors, select Reconnect (or Connect) next to iyedy and sign in again. In Claude Code, run /mcp, select iyedy, then Authenticate, and approve the access again on auth.iyedy.com.

A diagram I expect is missing

Claude only sees what your iyedy account can read, up to Confidential on a personal workspace and Internal in an organisation. For Claude, a diagram above that ceiling does not exist. Restricted diagrams are never shared.

“MCP clients are not enabled for this organization.”

Access for Claude is off in this organisation. An owner of the organisation asks support@iyedy.com to turn it on.

Your organisation requires single sign-on

Disconnect iyedy in Claude, connect again (in Claude Code: /mcp, select iyedy), and sign in with your work e-mail address, so that the sign-in goes through your organisation's single sign-on.

Claude says it has to wait

Too many calls in a short time. Wait a minute, then ask again.

Adding the custom connector fails

Check the address, https://app.iyedy.com/mcp. If you added iyedy before the evening of 29 October 2026, remove the connector and add it again. More causes: Claude troubleshooting.

iyedy shows twice in Connectors

You added iyedy as a custom connector before, then from the directory. You only need one. To keep one, open the custom one (under Custom) in Customize › Connectors, open the three-dot menu and select Remove. On a Claude Team or Enterprise plan, an Owner removes it in Organization settings › Connectors.

Was this page helpful?Your answer is anonymous and counts only if you accepted measurement.

What went wrong?

Don't write personal data.

Navigation

iyedy docs, home
Lire en françaisOpen iyedy

↑ ↓ moveEnter openCtrl Enter new tabSearching English docs ·