docs: troubleshooting mcp tools component missing tool mode (#11381)

* mcp-tool-mode-missing

* Apply suggestions from code review

Co-authored-by: April I. Murphy <36110273+aimurphy@users.noreply.github.com>

---------

Co-authored-by: April I. Murphy <36110273+aimurphy@users.noreply.github.com>
This commit is contained in:
Mendon Kissling
2026-01-22 17:45:58 -05:00
committed by GitHub
parent 7b16c1c5c0
commit a1ddb06301
2 changed files with 23 additions and 0 deletions

View File

@ -13,6 +13,10 @@ To do this, use the **MCP Tools** component's [HTTP/SSE mode](/mcp-client#mcp-ht
For more information, see [Use Langflow as an MCP client](/mcp-client) and [Use Langflow as an MCP server](/mcp-server).
:::tip Tool mode is missing
If you're upgrading an existing flow and the **MCP Tools** component loses its **Tool Mode** option, see [MCP Tools component loses Tool Mode option after upgrading flows](/troubleshoot#mcp-tools-component-loses-tool-mode-option-after-upgrading-flows).
:::
## MCP Tools parameters
| Name | Type | Description |

View File

@ -316,6 +316,25 @@ To work around this issue, run the server and host in the same operating environ
Alternatively, configure Langflow Desktop to accept connections from WSL at the default Windows IP address of `10.255.255.254:7860` instead of `localhost`.
### MCP Tools component loses Tool Mode option after upgrading flows {#mcp-tools-component-loses-tool-mode-option-after-upgrading-flows}
If you upgrade an existing flow that uses the [**MCP Tools** component](/mcp-tools) in **Tool Mode**, the component might lose its **Tool Mode** setting after upgrading the flow.
This can break flows that rely on the component's **Tool Mode** to expose MCP tools to agents.
If you experience this when upgrading a flow that you created in Langflow version 1.7.1 or earlier, do the following:
1. Select the **MCP Tools** component in your flow.
2. Click <Icon name="Code" aria-hidden="true"/> **Code** to open the component's code editor.
3. In the component's template structure, locate the `tool_mode` field under `inputs`.
The field can be either missing or set to `false`.
4. Add the `tool_mode` field if it's missing, and set it to `true`:
```python
tool_mode = True
```
5. Click **Check & Save** to apply the code changes.
## Token length limit errors in Embedding Model components
Token length errors can happen if your chunking strategy doesn't align with your embedding model's tokenization limits.