docs: Add troubleshooting for Ollama MCP tool calling #9257
+65
−2
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 troubleshooting section for Mistral/Gemma MCP tool calling errors - Document automatic message normalization in Ollama guide - Add guidance on choosing compatible models for MCP integration - Include links to troubleshooting from Ollama guide Related to PR #9253 Generated with Continue (https://continue.dev) Co-Authored-By: Continue <[email protected]> Co-authored-by: nate <[email protected]>
continue
bot
requested review from
Patrick-Erichsen
and removed request for
a team
dosubot
bot
added
the
size:M
7 tasks
![cubic-dev-ai[bot]](https://avatars.githubusercontent.com/in/1082092?s=60&v=4){kind=small}
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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
This PR adds documentation for the message normalization feature introduced in PR #9253.
Note: This is a documentation-only PR. It does not include any code changes from #9253 - those remain in that PR.
Changes
Troubleshooting Guide (
docs/troubleshooting.mdx)Ollama Guide (
docs/guides/ollama-guide.mdx)Documentation Approach
Related
Replaces
This agent session was co-authored by nate and Continue.
Summary by cubic
Adds troubleshooting and guidance for Ollama MCP tool calling, documenting automatic message normalization that fixes common Mistral (“Unexpected role 'system' after role 'tool'”) and Gemma (“unknown variant 'index'”) errors. Updates the Ollama guide with MCP compatibility notes, recommended models (DeepSeek, Qwen, Llama 3.1, Mistral), and links to troubleshooting; documentation-only, related to #9253 and addresses #9249.
Written for commit 0803219. Summary will update automatically on new commits.