Skip to main content

Setup (Codex)

Connect Adri MCP Server in Codex​

Use this guide to connect Adri MCP Server in Codex, then use it directly inside VS Code.

If you prefer Claude Code screenshots, use Setup (Claude Code).

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. Install the Codex VS Code extension from OpenAI docs: https://developers.openai.com/codex/ide
  4. Optional direct marketplace page: Visual Studio Code Marketplace

1. Setup Adri MCP Server in terminal (CLI)​

Run these commands in your project terminal:

npm install -g @openai/codex
codex login
codex mcp add sap_development_mcp_by_adri_ai --url https://mcp-server.getadri.ai/mcp/mcp/
codex mcp login sap_development_mcp_by_adri_ai
codex mcp list
codex mcp get sap_development_mcp_by_adri_ai

What this does:

  • Installs Codex CLI.
  • Signs you in.
  • Adds Adri MCP Server.
  • Opens OAuth login for Adri project access.
  • Confirms the server is connected and enabled.

Complete Codex CLI MCP setup in terminal

Official references:

2. Open Codex in VS Code and use Adri MCP Server​

  1. Open the VS Code Command Palette.
  2. Search for Codex: Open Codex Sidebar.

Search for Codex command in the VS Code command palette

  1. Select Codex: Open Codex Sidebar.

Select Codex Open Sidebar command

  1. Confirm the Codex panel opens on the right side.

Codex panel opened in the right sidebar

  1. Ask Codex: List all SAP systems.

Enter first prompt in Codex sidebar

  1. Verify Codex returns your SAP systems from Adri MCP Server.

Verify Codex response from Adri MCP tools

Troubleshooting​

Browser did not open automatically​

Copy the URL printed by codex mcp login ... and open it manually in any browser.

OAuth callback issues (port or remote/devbox environments)​

Configure callback settings in ~/.codex/config.toml:

mcp_oauth_callback_port = 55743
mcp_oauth_callback_url = "http://127.0.0.1:55743/callback"

Then retry:

codex mcp login sap_development_mcp_by_adri_ai

Re-authenticate from a clean state​

Remove stored OAuth credentials, then log in again:

codex mcp logout sap_development_mcp_by_adri_ai
codex mcp login sap_development_mcp_by_adri_ai

Still failing​

Validate the MCP endpoint and metadata:

curl -i https://mcp-server.getadri.ai/mcp/mcp/
curl https://mcp-server.getadri.ai/.well-known/oauth-protected-resource