Breadcrumbs

Configure an AI client manually

Apply config writes your AI client's configuration for you, in sapio365 and in the EZ Suite products alike. This page shows what it changes, and how to set a client up yourself when the product cannot write the file, or when you prefer to edit it.

What Apply config changes on your computer

Client

Configuration file

How the product writes it

Claude Code

%USERPROFILE%\.claude.json (user scope, all projects)

With claude mcp add --scope user when the claude command is found, otherwise by editing the file.

Claude Desktop

Microsoft Store version: %LOCALAPPDATA%\Claude-Data\claude_pzs8sxrjxfjjc\claude_desktop_config.json
Installer version: %APPDATA%\Claude\claude_desktop_config.json

Edits the file of each version installed. Claude Desktop starts its servers as programs, so each entry runs the mcp-remote bridge with npx.

Cursor

%USERPROFILE%\.cursor\mcp.json

Edits the file (mcpServers, with the address as url).

Visual Studio Code

%APPDATA%\Code\User\mcp.json

Edits the file (servers, type http).

Goose

%APPDATA%\Block\goose\config\config.yaml

Adds Streamable HTTP extensions under extensions, leaving the rest of the file as it is.

ChatGPT/Codex

%USERPROFILE%\.codex\config.toml

Only with the codex mcp add command: this file belongs to Codex.

  • The product only adds or removes its own entries; your other settings are kept, including the entries of other Ytria products. When it rewrites a JSON file, it lays the file out again: indentation and the order of the keys change, the content does not.

  • When the product replaces an existing file, it keeps the previous version next to it as <file>.ytria.bak.

  • Entries are recognized by their address, not their name: an entry you added by hand, under any name, counts, and the product does not add a duplicate.

Set up a client yourself

  1. Make sure the server is Running in the product's AI Settings panel.

  2. On the client's card, click the copy icon (Copy file path and config). The product copies the path of the client's configuration file, then the settings for both servers, its own and mcp-ytria-docs, with their actual addresses, in that file's own format: JSON for Claude Code, Claude Desktop, Cursor and Visual Studio Code, YAML for Goose, TOML for ChatGPT/Codex.

  3. Open the file at the copied path (create it if it does not exist yet) and paste the settings. In a file that already has content, add the entries to the section that is already there (mcpServers, servers or extensions) rather than adding a second one. The Codex sections go at the end of config.toml.

  4. Save the file and restart the client. The product recognizes the entries by their address and shows the client as Configured.

While the server is stopped, the icon copies the file path only (Copy file path): the settings carry the server's address, which is known once it runs. A client shown as Unavailable has no copy icon: use the reference below, with the address from Copy address.

Claude Code keeps much of its own state in .claude.json: rather than editing that file, run the claude mcp add commands below. For Claude Desktop, Settings > Developer > Edit Config opens the file it reads.

Reference settings

These examples are for sapio365, with its default address http://localhost:33380/sapio365/, and for the documentation server, at https://mcp-docs.ytria.com/mcp/. Copied from the panel, the settings carry your actual addresses.

  • For an EZ Suite product, use its own name and address: mcp-scanez with http://localhost:33380/scanez/, mcp-databaseez with http://localhost:33380/databaseez/, and so on (the name in the address is in lowercase).

  • For a second instance of a product, the name ends in -2 and so does the address: mcp-sapio365-2 with …/sapio365-2/.

  • The mcp-ytria-docs entry is the same for every product: one is enough.

  • If you change the port later, update the entries.

Claude Code

Under mcpServers in %USERPROFILE%\.claude.json:

JSON
{
  "mcpServers": {
    "mcp-sapio365":   { "type": "http", "url": "http://localhost:33380/sapio365/" },
    "mcp-ytria-docs": { "type": "http", "url": "https://mcp-docs.ytria.com/mcp/" }
  }
}

Or, in a terminal:

Bash
claude mcp add --scope user --transport http mcp-sapio365 http://localhost:33380/sapio365/
claude mcp add --scope user --transport http mcp-ytria-docs https://mcp-docs.ytria.com/mcp/
Claude Desktop

In Settings > Developer, click Edit Config to open the right file, and add under mcpServers (Node.js required):

JSON
{
  "mcpServers": {
    "mcp-sapio365": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:33380/sapio365/",
               "--transport", "http-only", "--allow-http"]
    },
    "mcp-ytria-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp-docs.ytria.com/mcp/",
               "--transport", "http-only", "--allow-http"]
    }
  }
}
Cursor

In %USERPROFILE%\.cursor\mcp.json:

JSON
{
  "mcpServers": {
    "mcp-sapio365":   { "url": "http://localhost:33380/sapio365/" },
    "mcp-ytria-docs": { "url": "https://mcp-docs.ytria.com/mcp/" }
  }
}
Visual Studio Code

In %APPDATA%\Code\User\mcp.json (MCP: Open User Configuration), or with MCP: Add Server:

JSON
{
  "servers": {
    "mcp-sapio365":   { "type": "http", "url": "http://localhost:33380/sapio365/" },
    "mcp-ytria-docs": { "type": "http", "url": "https://mcp-docs.ytria.com/mcp/" }
  }
}
Goose

Under extensions in %APPDATA%\Block\goose\config\config.yaml:

YAML
extensions:
  mcp-sapio365:
    enabled: true
    type: streamable_http
    name: mcp-sapio365
    uri: http://localhost:33380/sapio365/
    envs: {}
    env_keys: []
    headers: {}
    description: mcp-sapio365 MCP server
    timeout: 300
    bundled: null
  mcp-ytria-docs:
    enabled: true
    type: streamable_http
    name: mcp-ytria-docs
    uri: https://mcp-docs.ytria.com/mcp/
    envs: {}
    env_keys: []
    headers: {}
    description: mcp-ytria-docs MCP server
    timeout: 300
    bundled: null

Or run goose configure, choose Add Extension, then Remote Extension (Streamable HTTP), and enter the name mcp-sapio365 and its address; do the same for mcp-ytria-docs.

ChatGPT/Codex

At the end of %USERPROFILE%\.codex\config.toml:

[mcp_servers.mcp-sapio365]
url = "http://localhost:33380/sapio365/"

[mcp_servers.mcp-ytria-docs]
url = "https://mcp-docs.ytria.com/mcp/"

Or, in a terminal:

Bash
codex mcp add mcp-sapio365 --url http://localhost:33380/sapio365/
codex mcp add mcp-ytria-docs --url https://mcp-docs.ytria.com/mcp/