Connect Forge MCP to Claude Code

Connect Forge to Claude Code to build, configure, and debug your Leena AI bot from the terminal. Once connected, you can ask Claude Code to create an AOP, find out why a run failed, or update a tool, and Claude Code hands the request to Forge.

The setup takes about 10 minutes.

New to Forge MCP? Read Forge MCP and A2A first for the concepts and credentials, then follow this guide for the wiring.

Before you start

You need:

• Claude Code installed on your computer.
• A Leena AI dashboard account with access to the bot.
• The AI Colleague manage permission, to turn on Forge MCP and generate credentials.
• A web browser on the same computer, for the one-time sign-in.

Step 1 — Turn on Forge MCP in Leena AI

1. Open Admin console → Orchestrator → MCP server & A2A.
2. Select the Forge tab.
3. Turn on the MCP and A2A toggle.
4. Copy the MCP URL and the Client ID.

Step 2 — Generate a client secret

1. In OAuth 2.0 client credentials, click Generate client secret.
2. Copy the secret now. It is shown only once, so store it like a password.

The secret expires after 90 days. Regenerating it stops the old secret immediately. See Rotate the client secret.

Step 3 — Add the Claude Code redirect URL

Claude Code signs you in through a small local page on your computer, so Leena AI must allow that address.

1. In Authorized redirect URLs, add:

http://localhost:3334/callback

2. Click Save.

The port must match. 3334 must be the same as the --callback-port value in Step 4. If you use a different port, change it in both places. Use localhost; 127.0.0.1 is not accepted.

Step 4 — Add Forge to Claude Code

Open a terminal and run the command below. Replace <MCP_URL> and <CLIENT_ID> with the values you copied in Step 1:

claude mcp add --transport http \
  --scope user \
  --callback-port 3334 \
  --client-id <CLIENT_ID> \
  --client-secret \
  forge <MCP_URL>

Claude Code asks for the client secret. Paste the secret from Step 2.

Skipping the secret prompt. To skip the prompt, for example in a script, set the secret as an environment variable: MCP_CLIENT_SECRET=<secret> claude mcp add ...

Step 5 — Sign in with Leena AI

1. Start Claude Code by running claude.
2. Type /mcp, select forge, and choose Authenticate.
3. Your browser opens the Leena AI sign-in page. Sign in with your dashboard account and allow access.
4. The browser confirms that sign-in is complete. Go back to the terminal.

Claude Code renews your access automatically. Access tokens last 15 minutes and refresh tokens last 30 days. After a long break, you might be asked to sign in again.

Step 6 — Check that it works

In Claude Code, ask:

Use Forge to list the AI Colleagues on this bot.

Claude Code calls the forge tool and shows Forge's answer.

Example requests

Approving plans and answering questions

Before Forge makes changes, it shares a plan and asks for approval. It might also ask questions, such as which AI Colleague to use.

• Answer in the same Claude Code conversation. Claude Code passes your answer back to Forge in the same Forge conversation.
• To approve or decline a plan, say Approve plan or approve, or decline. A sentence such as "yes, but add a step" isn't read as a decision. Approve or decline first, then ask for the change.
• Steps finished in the dashboard. If Forge says a step must be finished in the Leena AI dashboard, open the link it gives, finish the step there, then reply Done.

Use Forge on more than one bot

Each connection works with one bot, because the credentials and sign-in are tied to that bot. To work on another bot, repeat Steps 1–5 with that bot's credentials, and give the server a different name, for example forge-hr and forge-it.

Rotate the client secret

A client secret expires after 90 days. Regenerating it stops the old secret immediately, so update Claude Code straight away:

1. On the Forge tab, click Regenerate client secret and copy the new secret.
2. In a terminal, remove the server and add it again with the new secret:

claude mcp remove forge --scope user
claude mcp add --transport http --scope user --callback-port 3334 \
  --client-id <CLIENT_ID> --client-secret forge <MCP_URL>

3. Sign in again with /mcp.

Remove Forge from Claude Code

claude mcp remove forge --scope user

Troubleshooting