Codex: Set up the Visily MCP server

Codex: Set up the Visily MCP server

Connect Codex directly to the Visily MCP server (no plugin).

Before you start

  1. The Visily MCP works only on workspaces on a Pro or Business plan where you are the workspace creator or have an editor license. Free workspaces and viewer/guest roles are not supported.
  2. Server URL: https://app.visily.ai/api/mcp

Add the server

Codex talks to remote (HTTP) MCP servers through its experimental rmcp client. Add the server to ~/.codex/config.toml:
Quote
[mcp_servers.visily]
experimental_use_rmcp_client = true
Notes
The experimental_use_rmcp_client flag is required for Codex to use the streamable-HTTP transport.

Authenticate (OAuth)

Restart Codex or start a new thread so the config is picked up, then:
Quote
codex mcp login visily --scopes workspaces:read,boards:read,elements:read,design:read
Complete the OAuth login in your browser and approve the scopes. Once connected, the Visily tools (list_boards, get_design_context, …) are available.

Verify

Quote
codex mcp list   # confirm the "visily" MCP server is configured

Prefer the packaged plugin?

The plugin bundles the same server plus the Visily skill. See Codex Plugin Guide.

Need more help?
If this does not solve your issue, contact support and include a screenshot if possible.