Connect Codex or ChatGPT

Use the hosted Gradient Dynamics MCP endpoint: https://api.gradient-dynamics.com/mcp.

Codex

For a bearer key, add the following to your Codex MCP configuration and supply GD_API_KEY through your environment or secret manager:

[mcp_servers.gradient_dynamics]
url = "https://api.gradient-dynamics.com/mcp"
bearer_token_env_var = "GD_API_KEY"

For OAuth, omit bearer_token_env_var and, when the Gradient Dynamics environment enables OAuth, run:

codex mcp login gradient_dynamics
codex mcp list

Codex supports Streamable HTTP and environment-backed bearer tokens. See the official MCP configuration guide for current client settings and login behaviour.

ChatGPT

Use the available custom MCP/plugin connection flow with the same endpoint and an enabled OAuth connection. Account and workspace policies determine access. Follow the current client UI; do not paste an API key into a description or conversation. See OpenAI’s plugin connection requirements.

Verify the connection

Ask the agent to discover the geometry template catalogue and explain a selected template without starting a geometry, mesh or simulation job. Then follow agent workflow for an authorized engineering task.

On authorization errors, check the credential, scope and resource ownership. On budget refusals, report the stated limit. Reconnecting is not permission to increase a budget or rerun compute.