Create MCP Config

Create .vscode/mcp.json in your project:

{
  "servers": {
    "oswiki": {
      "type": "http",
      "url": ""
    }
  }
}

Add as a Connector (recommended)

Claude Desktop connects to remote MCP servers through Connectors - no config file needed.

Settings → Connectors → Add custom connector → paste the URL:

Alternative: config file via mcp-remote

The config file only accepts stdio servers (a "url" entry is rejected), so bridge it with mcp-remote. Requires Node.js.

# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "oswiki": {
      "command": "npx",
      "args": ["mcp-remote", ""]
    }
  }
}

Restart Claude Desktop

Close and reopen Claude Desktop; the OSWiki tools appear in the tools menu.

Add the server

One command, from any terminal:

claude mcp add --transport http oswiki 

Or per project

Commit a .mcp.json in the project root so the whole team gets it:

{
  "mcpServers": {
    "oswiki": {
      "type": "http",
      "url": ""
    }
  }
}

Verify

Run /mcp inside Claude Code - oswiki should show as connected with 12 tools.

Endpoints

# Health
GET 

# Tools
GET 

# Call
POST 
{
  "tool": "search_docs",
  "arguments": { "query": "m-cube" }
}

cURL

curl -X POST  \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_docs","arguments":{"query":"animation"}}'