MCP

Connect your first serverCopy Anchor Link

Use MCP when a service or tool already publishes an MCP server and you want omp to work with it—for example, to search an issue tracker, query a database, or use a filesystem outside the current project. You configure the server once, then ask for the work in ordinary language.

/mcp add

/mcp test filesystem

Minimal configurationCopy Anchor Link

For a local server, create .omp/mcp.json in the project. This example starts the official filesystem server and grants it access only to one directory:

{
  "$schema": "https://raw.githubusercontent.com/can1357/oh-my-pi/main/packages/coding-agent/src/config/mcp-schema.json",
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/alice/Documents"
      ]
    }
  }
}

Replace the path with an absolute directory on your machine. stdio is the default transport when type is omitted.

If you edit the file while omp is running, apply and verify the change with:

/mcp reload
/mcp list
/mcp test filesystem

/mcp list groups servers by source and shows whether each one is connected, connecting, inactive, disabled, or not connected.

Where omp looksCopy Anchor Link

You often do not need to copy an existing MCP setup. omp automatically imports supported server definitions from Claude Code, Codex, Gemini CLI, OpenCode, Cursor, Windsurf, VS Code, installed plugins, and extension packages. Run /mcp list to see what was found and which file supplied it.

For configuration owned by omp, prefer:

Project MCP discovery is enabled by default. The first definition found for a duplicate server wins; definitions are not merged. /mcp add, /mcp enable, /mcp disable, and OAuth commands write only omp-managed files, not another application's config.

TransportsCopy Anchor Link

Choose the transport published by the server. A URL ending in /sse does not by itself select SSE; set type explicitly for every remote server. A server cannot have both command and url.

{
  "$schema": "https://raw.githubusercontent.com/can1357/oh-my-pi/main/packages/coding-agent/src/config/mcp-schema.json",
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/alice/Documents"
      ]
    }
  }
}

Authentication and secretsCopy Anchor Link

Bearer tokens and API keysCopy Anchor Link

Put credentials for a local process in env, or credentials for HTTP/SSE in headers. Reference an environment variable instead of committing the secret:

{
  "mcpServers": {
    "acme": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${ACME_TOKEN}"
      }
    }
  }
}

omp expands ${VAR} and ${VAR:-default} in server configuration when it loads the file. In env and headers, a whole value that names an environment variable also resolves from the process environment. A value beginning with ! runs the remaining shell command and uses its trimmed output; use that only with a command you trust.

Although auth.type: "apikey" is accepted by the schema, it does not fetch and inject an API key. Use env or headers for API keys.

OAuthCopy Anchor Link

For an HTTP or SSE server that supports OAuth, leave the token out and run:

/mcp reauth acme

omp opens the authorization flow and stores the credential in the active profile's auth storage (agent.db, or the configured auth broker), not in mcp.json. Use /mcp unauth acme to remove it. If the provider requires a registered client, add only the settings it requires:

{
  "mcpServers": {
    "acme": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "oauth": {
        "clientId": "${ACME_CLIENT_ID}",
        "clientSecret": "${ACME_CLIENT_SECRET}"
      }
    }
  }
}

Inspect and control serversCopy Anchor Link

/tools shows every tool currently visible to omp. MCP tool names appear as mcp__<server>_<tool> after names are lowercased and normalized to underscores. omp may remove a repeated server prefix or shorten a very long name. These names help you identify where a capability came from; continue requesting work in natural language.

Connected servers may also publish prompts, resources, and notifications. /mcp prompts shows callable prompt commands in the form /server:prompt. Resource updates enter the conversation only when mcp.notifications is enabled; the default is off.

SafetyCopy Anchor Link

TroubleshootingCopy Anchor Link

Server field referenceCopy Anchor Link

User config may also contain disabledServers and enabledServers arrays. The denylist has highest precedence.

These related settings live in ~/.omp/agent/config.yml (or the active profile's config):

mcp:
  enableProjectConfig: true
  renderMarkdownResults: true
  notifications: false
  notificationDebounceMs: 500

Those are the defaults. notificationDebounceMs controls how long resource updates are grouped before they enter the conversation.

RelatedCopy Anchor Link

Source: omp.sh — MIT, Stencil Labs. Initially imported on 2026-10-03; updates via automatic sync.