We don't publish
your competitive advantage.

IF404 Not Found errors on SSE or messages endpoints when using custom message_path or mounting MCP server under a subpath.

THENEnsure the `message_path` in FastMCP matches the expected route relative to the mount point. When mounting the SSE app under a prefix (e.g., `/mcp`), the message_path should start with that prefix (e.g., `/mcp/messages/`). Verify that the client connects to the correct base URL and that the server does not double-append paths. Avoid using uvicorn workers with fastapi-mcp, as shared state can cause routing issues.

IFYou want MCP server configuration to be available across multiple projects or globally, not per-project.

THENPlace the MCP client configuration file (e.g., claude_desktop_config.json) in your home directory instead of project-specific directories. If your MCP client supports global config, this applies the server settings to all projects.

IFMCP server fails to initialize in Claude Desktop with JSON parsing error 'Unexpected token 'E', 'Error: typ'...'

THENAdd the '--directory' argument with the full path to the project directory in the claude_desktop_config.json args for the server command, before 'run' and the server script path. This ensures UV resolves the correct home directory.

IFAfter reinstalling opencode and oh-my-opencode, the websearch_exa MCP server fails to connect with a timeout error because it is detected as remote instead of local.

THENEnsure the MCP server is configured as a local tool in opencode.json or the appropriate configuration file. Set the type to 'local' and provide the correct command and arguments. If using environment variables, verify they are correctly forwarded to the MCP process.

IFwebsearch_exa MCP server times out after reinstalling opencode and oh-my-opencode, detected as remote instead of local.

THENVerify the MCP server configuration in opencode.json. Ensure the server is set to a local type (e.g., command-based) or that the remote endpoint URL is correct. If the server was previously working without an API key, a local configuration (e.g., a local executable) is likely needed. Re-add the MCP server with the proper 'type' field (e.g., 'local') and corresponding command.

IFYou want to customize MCP server behavior (auth, filters, port, transport) beyond default CLI options.

THENCreate an `apifold.config.yaml` file that specifies the spec, port, transport, baseUrl, auth type, and filters (tags, methods). The CLI will pick it up automatically.