docs: Add agent configuration guide and troubleshooting for issue #2311 #137
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
- Add comprehensive agent configuration guide (docs/AGENT_CONFIGURATION.md) - Add issue template for agent tool routing problems - Add detailed troubleshooting guide (docs/TROUBLESHOOTING.md) - Document solutions for agents wrapping MCP tools in Bash() calls - Provide README addition with agent-specific configuration examples Addresses known client-side issue where AI agents incorrectly execute MCP tools as bash commands instead of routing through MCP protocol. Related to firecrawl/firecrawl#2311
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Adds comprehensive documentation for resolving agent tool routing issues where agents incorrectly execute MCP tools as bash commands (related to firecrawl/firecrawl#2311).
Changes
docs/AGENT_CONFIGURATION.md) - Step-by-step solutions for multiple clients.github/ISSUE_TEMPLATE/agent-tool-routing.md) - Structured template for reportingdocs/TROUBLESHOOTING.md) - Complete diagnostic reference (7.4 KB)docs/README_ADDITION.md) - Agent-specific configuration sectionWhy
Users experience agents wrapping MCP tool calls in
Bash()execution instead of using the MCP protocol, resulting in "command not found" errors. This is a client-side configuration issue, not an MCP server bug.Documentation includes
Related Issues
Verification