Skip to main content

Setup (Claude Code)

Connect Adri MCP Server in Claude Code​

Adri MCP Server works with any MCP-compatible coding agent, including Codex, Cline, Claude Code, and others. This walkthrough uses Claude Code screenshots, but the server URL and auth flow are the same idea across agents. If you are new: MCP is the standard way coding agents use external tools like Adri AI. For advanced SAP-side capabilities (parametrized execution and better large-table pagination), also complete Setup Enabler Framework.

Using Codex CLI instead? See Setup (Codex).

In every screenshot, the red box shows where to focus.

Pre-requisites​

  1. Complete the one-time tool install guide: Install VS Code and Agent Tools
  2. Log in to Adri AI: https://www.getadri.ai/login
  3. Log in to Claude: https://claude.ai/login
  4. Verify Claude Code CLI is installed.
  5. Verify the Claude Code VS Code extension is installed.

Run this check for step 4:

claude --version

Claude Code VS Code extension guide: code.claude.com/docs/en/vs-code

If Claude Code CLI is not installed yet, use the official quickstart: code.claude.com/docs/en/quickstart

1. Create .mcp.json in your project​

  1. Open your project folder in VS Code.
  2. Click New File in the Explorer.

Click New File in VS Code Explorer

  1. Type .mcp.json and press Enter.

Start entering the new filename

Name the file .mcp.json

  1. Open the new file.

Open the .mcp.json editor

  1. Paste this config:

This file tells your coding agent how to reach Adri MCP Server.

{
"mcpServers": {
  "adri-ai": {
    "type": "http",
    "url": "https://mcp-server.getadri.ai/mcp/mcp/"
  }
}
}

Paste Adri MCP server config in .mcp.json

2. Open MCP servers in Claude Code​

  1. Open Claude Code in VS Code.
  2. Run /mcp and select MCP servers.

Run /mcp and open MCP servers

3. Authenticate the adri-ai MCP server​

  1. In MCP servers, find adri-ai and click Needs Auth.

Click Needs Auth for adri-ai

  1. Click Authenticate.

Click Authenticate

  1. When prompted, click Open to launch browser auth.

Allow VS Code to open the auth URL

  1. In the browser, select the Adri project you want and continue.

Select a project for MCP access

  1. Click Allow.

Allow Claude Code to access Adri AI

  1. After Authentication Successful, return to VS Code.

Authentication successful page

  1. Confirm adri-ai shows Connected.

Verify adri-ai is connected

4. Run your first prompt​

  1. Ask Claude: List all SAP systems.

Run first prompt in Claude Code

  1. When tool permission appears, choose the option that allows mcp__adri-ai__... for all projects.

Important:

  • If the prompt shows this session, click this session and change it to all projects.
  • Then select Yes, allow ... for all projects.

Permission prompt showing "this session" scope

Switch scope to "all projects" and allow

  1. Verify Claude returns the SAP systems list.

Successful response showing available SAP systems