MCP SERVERS
Connecting AI Clients
How to connect any MCP-compatible AI client to API Studio's Management MCP server — Claude Desktop, Cursor, Kiro, VS Code Copilot, Amazon Q, and headless CLI environments.
Overview
Any MCP-compatible AI client can connect to API Studio's MCP servers. The Management MCP server exposes 33 tools for full workspace control — collections, environments, requests, mock servers, and more.
Connection URL
http://127.0.0.1:{port}/mcp — default Management MCP port is 3199
Transport
Supports both HTTP (streamable) and stdio transport. Use HTTP for most clients; stdio for environments that prefer subprocess communication.
MCP Connect Panel
The MCP Connect panel in the UI shows connection instructions for each client — including the URL, config snippets, and the stable stdio script path.
Management MCP Enabled. The server must be running for clients to connect.
Recommendation: Use stdio over HTTP for stability
The HTTP transport (http://127.0.0.1:3199/mcp) can be unstable when:
- Multiple VS Code windows are open (only the first window owns the port)
- Another process is already using port 3199
- VS Code restarts or the extension reloads (brief connection gap)
stdio is more reliable — it launches a dedicated subprocess per AI client, avoids port conflicts, and works even when the extension hasn't started yet. Use the stable script path:
/usr/local/bin/node ~/.openpost/global/mcp-stdio.jsUse the full path to node (e.g., /usr/local/bin/node on macOS, C:\Program Files\nodejs\node.exe on Windows) for consistent behavior across shells and environments. Find yours with which node or where node.
Claude Desktop
Edit your Claude Desktop configuration file to add API Studio as an MCP server.
Config file location:
~/.config/claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonStdio transport (recommended — more stable):
{
"mcpServers": {
"api-studio": {
"command": "/usr/local/bin/node",
"args": ["/Users/YOUR_USERNAME/.openpost/global/mcp-stdio.js"]
}
}
}Replace /usr/local/bin/node with output of which node. Replace YOUR_USERNAME with your actual home path.
HTTP transport (alternative — may have port conflicts):
{
"mcpServers": {
"api-studio": {
"url": "http://127.0.0.1:3199/mcp"
}
}
}