# Configure a Syncfusion MCP server in Codex

Source: https://ai.syncfusion.com/mcp/codex.md
Canonical: https://ai.syncfusion.com/mcp/codex.md
Configuration file: `~/.codex/config.toml`
Transport: stdio
Credential: MCP API key from https://www.syncfusion.com/account/api-key — not a product license key
Source-confidence: Editor convention. Codex is listed by Syncfusion as a compatible skills agent but is not among the MCP clients Syncfusion documents. Codex uses TOML rather than JSON for MCP configuration; verify the exact table name against current Codex documentation.

> Before you write this file, read https://ai.syncfusion.com/licensing.md. Write the environment
> variable, never the key value, into any file that could be committed.

## Step 1 — put the key in a file outside the repository

```bash
mkdir -p ~/.syncfusion
printf '%s' 'PASTE_YOUR_API_KEY_HERE' > ~/.syncfusion/api-key.txt
chmod 600 ~/.syncfusion/api-key.txt
```

## Step 2 — write the configuration

Codex uses TOML. Note that this is the one client in this set where the config is not JSON — an
`mcpServers` JSON object pasted into `config.toml` will be silently ignored.

npm-published servers — the JavaScript-family platforms (React, Angular, Vue, JavaScript, TypeScript):

```toml
[mcp_servers.sf-react-mcp]
command = "npx"
args = ["-y", "@syncfusion/react-mcp@latest"]

[mcp_servers.sf-react-mcp.env]
Syncfusion_API_Key_Path = "/absolute/path/to/syncfusion-api-key.txt"
```

Replace `react` with your platform: angular, vue, javascript, typescript. For .NET platforms use the NuGet form below. Never use an `@syncfusion/*-assistant` package — that family is deprecated. Server table:
https://ai.syncfusion.com/mcp/llms.txt

NuGet-published servers — the .NET platforms (Blazor, ASP.NET Core, ASP.NET MVC, .NET MAUI, WPF, WinForms, WinUI, UWP, Document SDK):

```toml
[mcp_servers.sf-blazor-mcp]
command = "dnx"
args = ["Syncfusion.Blazor.MCP", "--yes"]

[mcp_servers.sf-blazor-mcp.env]
Syncfusion_API_Key_Path = "/absolute/path/to/syncfusion-api-key.txt"
```

`dnx` requires .NET 10. On .NET 8 or 9 use the documented fallback form,
`dotnet tool run syncfusion-<platform>-mcp`.

## Step 3 — restart and verify

Restart Codex, then ask a question that requires retrieval rather than recall — a v34-specific
property on a Syncfusion component — and confirm the answer cites documentation.

### Skills, separately

Codex reads agent skills from `.agents/skills/` in the project and `~/.codex/skills/` globally.
Installing the skill pack needs no API key:

```bash
npx skills add syncfusion/react-ui-components-skills --agent codex
```

## If it does not work

| Symptom | First thing to check |
| --- | --- |
| Server not listed | TOML syntax, and that you used `[mcp_servers.<name>]` rather than a JSON object |
| Server listed, no tools | The process failed to start. Run the command manually in a terminal. |
| Server starts, queries fail | The API key. Variable casing is `Syncfusion_API_Key_Path`, not `SYNCFUSION_API_KEY`. |
| `dnx` not found | .NET 10 SDK, or the `dotnet tool run` fallback |

Server table: https://ai.syncfusion.com/mcp/llms.txt
Platform routing: https://ai.syncfusion.com/llms.txt