TroubleshootingOfficial documentation12 min readIssue list

FastGPT Agent and MCP Issue List

Find 29 FastGPT Agent and MCP troubleshooting articles by symptom, with checks for tool calls, connectivity, and version compatibility.

This page collects the 29 published documents about the agent runtime and MCP tool integration, grouped by symptom, so a document can be found directly from what the error looks like.

Three symptoms that belong to this stage

  1. An agent returns an empty response or stops partway
  2. The MCP tool list fails to load or a tool call has no effect
  3. Tool parameters or return structures do not match expectations

If none of the three match, go back to the deployment and environment issue landscape and narrow down again.

The general order for this stage

  1. Take the full error from the backend service log for this stage's component, including the component name and error code
  2. Verify from inside the deployment that the component can be reached on its own, ruling out network and permission causes
  3. Check the component version against the main service version
  4. Follow the entry below whose symptom is closest, then repeat the same operation to verify

Published documents (29)

DocumentArea
Archive and Clean Up Legacy FastGPT Sandboxesdeploy
Bind Skills to FastGPT Agent Applicationstutorial
Control Tool Call Cycles and Workflow Variablesnode
Define and Use FastGPT AI Agent Skillstutorial
Describe FastGPT Agent Virtual Machine Featurestutorial
Develop FastGPT Agent Plugin Standard Workflowsmodel
Enable FastGPT app exposure via MCP protocolintegration
Execute JavaScript in FastGPT Sandbox Nodesnode
FastGPT 4.16 Sandbox and Runtime Enhancementsdeploy
FastGPT Agent Loop and Workflow Bug Fixesdeploy
FastGPT Agent V2 VM Session Isolation and Lifecycletutorial
FastGPT Skill Layer Core Design Philosophytutorial
FastGPT Virtual Machine Agent Startup Script Constraints & Fault Tolerancetutorial
General Debugging for FastGPT Agent Chat Previewstutorial
List of Allowed JavaScript Modules in FastGPT Sandbox V2node
List of Permitted Python Modules for FastGPT Sandbox V2node
Make External HTTP Requests in FastGPT Sandboxnode
Manage and Use FastGPT Backend Sandbox Terminaltutorial
Prevent Repeated Execution of Skill Scriptstutorial
Run Custom Python Code in FastGPT Sandbox V2node
Secure Code Execution via FastGPT Sandbox Nodenode
Set Up Agent V2 For Dynamic Data Analysistutorial
Set Up FastGPT Intelligent Data Analysis Agenttutorial
Set Up a Dataset-Powered Legal Q&A Agenttutorial
Set Up and Manage FastGPT MCP Serversintegration
Understand the FastGPT Sandbox Security Restrictionsnode
Unified Agent and Tool Call Execution for FastGPTdeploy
Update FastGPT OpenSandbox for 4.15 Deploymentdeploy
Verify FastGPT Agent V2 Analysis Outputstutorial

What this list does not cover

Entries cover cases that can be reproduced publicly, grouped by symptom. The following need separate confirmation:

  • A symptom caused by several factors at once, which needs the order above to rule them out one by one
  • The same symptom caused by configuration specific to the commercial edition
  • Cases coupled to a particular infrastructure environment that cannot be reproduced in a standard deployment

Keep reading

References

If the problem is still not located

The entries above cover cases that can be reproduced from public information. If the problem depends on configuration details of a specific deployment, or needs runtime logs to confirm, contact sales for deployment-stage support; the cloud service can be used directly without handling environment dependencies.

  • Contact sales: support for self-hosting and upgrades
  • Get started: use the cloud service and skip environment setup
  • Pricing: compare what the cloud and self-hosted forms cover

Related content

TroubleshootingFastGPT Containers and orchestration Issue ListTroubleshootingFastGPT Databases and object storage Issue ListTroubleshootingFastGPT Images and architecture Issue List