Skip to content

mcp-troubleshooting.md

Latest commit

 

History

History
38 lines (24 loc) · 948 Bytes

mcp-troubleshooting.md

File metadata and controls

38 lines (24 loc) · 948 Bytes

MCP Troubleshooting

Server Does Not Start

Check that the package is built:

npm run build
node dist/mcp/server.js

If installed from npm, use:

opencode-plusplus-mcp

Client Cannot Find Tools

Confirm that the client is configured for a stdio MCP server and points to opencode-plusplus-mcp or node dist/mcp/server.js.

Runtime Tools Look Advisory

That is expected for Agent-led MCP mode. The host agent still decides whether to obey the returned gates. For OpenCode++ to evaluate gates after executor output, use the harness-led CLI path:

opencode-plusplus orchestrate "<task>" . --executor mock --max-loops 3

Missing Evidence

Use command-captured trace evidence:

opencode-plusplus trace run <trace-id> . --action run-test --command "npm test"

Manual evidence is useful for notes, but command evidence includes exit code, timestamps, output hashes, and working-tree hashes.