Does Codex support the Metorial Admin MCP server?

Yes. Codex connects to the Metorial Admin MCP server through one CLI command, pointed at your Metorial URL. You need the Codex CLI, IDE extension or ChatGPT desktop app.

Do I need an API key to connect Metorial Admin to Codex?

No. You sign in to Metorial Admin once through Metorial, and Codex uses that connection. No API keys go into Codex's settings.

Which Metorial Admin tools can Codex use?

All 427 Metorial Admin tools your team allows, such as List Endpoints, List Instances, Call Endpoint. Admins can narrow that list per team.

Can I control which teammates use Metorial Admin in Codex?

Yes. Role-based access control decides who can use Metorial Admin and which of its tools appear in Codex, and every call is logged with the person's identity.

What if Codex doesn't show Metorial Admin tools?

Codex can connect without credentials and then see nothing. Run codex mcp login metorial to complete the OAuth sign-in.

Connect Metorial Admin to Codex (MCP setup guide)

Ask Codex to use the get skill item tool in Metorial Admin
Ask Codex to use the get identity actor tool in Metorial Admin
Ask Codex to use the get provider deployment tool in Metorial Admin
Ask Codex to use the get session event tool in Metorial Admin
Ask Codex to use the terminate sandbox machine tool in Metorial Admin

1. Enable Metorial Admin in Metorial
In your Metorial portal, enable the Metorial Admin MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
2. Add the server and sign in
The Codex CLI, IDE extension and ChatGPT desktop app share this config.
```
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
```
3. Check the connection
Type /mcp in Codex to see Metorial and its Metorial Admin tools.

Once Metorial Admin is enabled in Metorial, teammates sign in with SSO and get the same connection in Codex, with only the tools their role allows.

One link covers every app you approve. See how the MCP gateway handles access, roles and audit logs for the whole company.

List Endpoints: List callable Metorial dashboard instance API endpoints from runtime introspection.
List Instances: DEPRECATED — use `instance_list` instead.
Call Endpoint: Call a Metorial dashboard instance API endpoint that appears in list_endpoints.
Get Instance: DEPRECATED — use `instance_get` instead.
Get Account Context: Read the authenticated credential type and its organization, project, instance, actor, and user context when available.
Delete provider config: Permanently deletes a provider config.
Get provider config: Retrieves a specific provider config by ID.
List provider deployments: Returns a paginated list of provider deployments.
List provider collections: Returns a paginated list of provider collections.
List provider auth configs: Returns a paginated list of provider auth configs.
Create skill import: Queues a skill import from a repository or uploaded file.
Get provider run: Retrieves a specific provider run by ID.
List magic MCP endpoints: Returns a paginated list of magic MCP endpoints.
Create identity delegation: Creates a new identity delegation.
Get identity delegation request: Retrieves a specific identity delegation request by ID.
And 412 more on the Metorial Admin MCP server page.

Limit which Metorial Admin tools Codex sees with enabled_tools and disabled_tools on the metorial server in config.toml.
Set default_tools_approval_mode to auto, prompt, writes or approve. writes prompts only for tools that are not marked read-only.
Type /mcp in the composer to see the connected servers.
Override the approval behavior for a single Metorial Admin tool with tools.<tool>.approval_mode.

Metorial is listed but tools are missing: Codex can connect without credentials and then see nothing. Run codex mcp login metorial to complete the OAuth sign-in.
Metorial times out at startup: Codex waits 10 seconds by default. Raise startup_timeout_sec under [mcp_servers.metorial] in ~/.codex/config.toml.
Long tool calls fail after a minute: The default tool timeout is 60 seconds. Raise tool_timeout_sec for the metorial server in config.toml.

Based on the Codex MCP documentation.

Frequently asked questions

Common questions about connecting Metorial Admin to AI agents with Metorial.

Does Codex support the Metorial Admin MCP server?
Yes. Codex connects to the Metorial Admin MCP server through one CLI command, pointed at your Metorial URL. You need the Codex CLI, IDE extension or ChatGPT desktop app.
Do I need an API key to connect Metorial Admin to Codex?
No. You sign in to Metorial Admin once through Metorial, and Codex uses that connection. No API keys go into Codex's settings.
Which Metorial Admin tools can Codex use?
All 427 Metorial Admin tools your team allows, such as List Endpoints, List Instances, Call Endpoint. Admins can narrow that list per team.
Can I control which teammates use Metorial Admin in Codex?
Yes. Role-based access control decides who can use Metorial Admin and which of its tools appear in Codex, and every call is logged with the person's identity.
What if Codex doesn't show Metorial Admin tools?
Codex can connect without credentials and then see nothing. Run codex mcp login metorial to complete the OAuth sign-in.