Use iyedy in Claude Code

Add iyedy to Claude Code with one command and sign in once in your browser. Claude can then list your diagrams, read a view, follow dependencies across diagrams, run the checks and prepare a change that a person applies in iyedy.

Before you start

• An iyedy account. Sign in once at app.iyedy.com with the identity you will use, and finish creating your account. Without it, every tool answers that no iyedy account uses this sign-in yet.
• Claude Code installed on your computer and signed in to your Claude account.
• A browser on the same machine for the sign-in, or another device for the variant without a browser (below).
• In an iyedy organisation (Team, Enterprise), access for MCP clients is off until an owner asks support to turn it on: see Claude and MCP for your organisation. Your personal workspace works right away.

Set up

1. Add iyedy to Claude Code

   Run this once in your terminal:

   TerminalCopy

   $ 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

   --transport http points Claude Code at iyedy's hosted server, --scope user makes iyedy available in all your projects, and --client-id claude-code tells iyedy's sign-in that the request comes from Claude Code: keep it in the command.

   Coming soonSimpler sign-in for Claude Code.

2. Sign in to iyedy

   In a Claude Code session, run /mcp, select iyedy, then Authenticate. From the shell, this does the same:

   TerminalCopy

   $ claude mcp login iyedy

   Your browser opens iyedy's sign-in page on auth.iyedy.com. Sign in as you do in the app: e-mail and password, Google, or your organisation's single sign-on.

3. Approve the access

   The access page says that Claude Code wants to use your iyedy account and lists what it will be able to do. Check the address, then select Allow.

   auth.iyedy.com1

   Claude Code wants to use your iyedy account

   Claude Code will be able to:

   • Read your iyedy diagrams: models, views, versions and findings
   • Search elements and analyse impact across your iyedy diagrams
   • Preview changes and submit proposals that a person reviews in iyedy

   2

   DenyAllow3

4. Check the connection

   Run:

   TerminalCopy

   $ claude mcp list

   iyedy is listed as connected. Then ask Claude, in your own words: “List my iyedy diagrams, then describe the containers view of Claims Platform.”

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

On a machine without a browser

On a remote server or in a container, sign in with this command, open the address it prints on another device, and approve the access there:

$ claude mcp login iyedy --no-browser$ claude mcp login iyedy \
    --no-browser

For a job that runs with nobody at the keyboard, OAuth is the wrong tool: an MCP client can connect with a personal access token instead. See Connect another MCP client.

What Claude Code asks before acting

iyedy marks each of its 24 tools. The 22 reading tools are read-only: they change nothing, and Claude Code can run them without asking if you allow it in its permissions. The two tools that store something, submit_proposal and withdraw_proposal, are marked destructive, so Claude Code asks for your approval before each call. Even then, the model of your diagram does not change: a proposal waits in iyedy until a person who can edit the diagram applies or rejects it. See How proposals reach your team.

How long the sign-in lasts

Claude Code keeps the sign-in for you. It stays valid as long as you use it at least once every 30 days; after a longer pause, Claude Code asks you to sign in again. Everything Claude reads goes through your iyedy account: the same diagrams, the same roles, never more. Details: Sign-in, permissions and disconnecting.

Disconnect

To make Claude Code forget the sign-in:

$ claude mcp logout iyedy

To remove iyedy from Claude Code:

$ claude mcp remove iyedy

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

If it doesn't work

$ claude mcp remove iyedy

More symptoms: Claude troubleshooting.