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. For advanced SAP-side capabilities (parametrized execution and better large-table pagination), also complete Setup Enabler Framework.

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