siyuan-plugins-mcp-sisyphus: Skill for Codex

Configure Claude Desktop MCP Apps

Configure the active Claude Desktop installation safely, then verify the transport, tools, and interactive MCP App separately. Treat a connected server and a rendered MCP App as two different success criteria.

Gather connection details

Obtain:

• MCP endpoint URL, such as http://127.0.0.1:36806/mcp
• Server name to place under mcpServers
• Authentication requirements, if any
• At least one read-only tool call for verification
• An MCP App resource or tool that returns text/html;profile=mcp-app

Confirm the MCP service is already running before editing Claude. Do not expose tokens in terminal output, screenshots, logs, or the final response.

Locate the active Claude configuration

Prefer Claude Desktop's Settings → Developer → Edit Config action because it targets the configuration used by that installation.

When inspecting from the terminal, search before assuming the directory name:

find "$HOME/Library/Application Support" -maxdepth 2 \
  -name claude_desktop_config.json -print

Common locations include:

• ~/Library/Application Support/Claude/claude_desktop_config.json
• ~/Library/Application Support/Claude-3p/claude_desktop_config.json

The Sisyphus setup observed Claude-3p; do not blindly write to the more familiar Claude directory. If multiple files exist, correlate the path with Edit Config, the running app, or its Developer settings.

Merge the MCP server entry

Read and parse the existing JSON first. Preserve unrelated top-level keys and existing mcpServers. Create a recoverable backup before changing a live user configuration. Request permission before writing outside the current workspace.

For a local Streamable HTTP Sisyphus server, merge this entry:

{
  "mcpServers": {
    "siyuan-sisyphus": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "http://127.0.0.1:36806/mcp"
      ]
    }
  }
}

Use the snippet as a merge fragment, not as a replacement for the whole file. Validate the final file as JSON after editing.