MCP Server Troubleshooting
This skill requires the MongoDB MCP Server with Atlas Stream Processing tools enabled. If these tools are unavailable, follow the diagnostic steps below.
Overview
MCP Server Troubleshooting
This skill requires the MongoDB MCP Server with Atlas Stream Processing tools enabled. If these tools are unavailable, follow the diagnostic steps below.
Step 1: Verify MCP Server Connection
Check if the MongoDB MCP Server is connected to your environment.
If not connected:
- Install the MongoDB MCP Server
- Configure it with your Atlas API credentials (
apiClientIdandapiClientSecret)
Step 2: Verify Tool Availability
Check that all four streams tools are available:
atlas-streams-discoveratlas-streams-buildatlas-streams-manageatlas-streams-teardown
Fallback Options (Limited Functionality)
If you cannot configure the MCP server immediately, you have limited alternatives:
Option 1: Atlas CLI (Read-Only)
Use Atlas CLI API commands for exploration only:
atlas api streams listStreamWorkspaces --projectId <project-id>
atlas api streams getStreamWorkspace --workspaceName <workspace-name> --projectId <project-id>
Limitations:
- Read-only operations only
- Cannot create or modify processors
- No automated validation or diagnostics
Option 2: mongosh with sp.process() (Prototyping Only)
Use sp.process() in mongosh for ephemeral pipeline testing:
sp.process([
{ $source: { connectionName: "sample_stream_solar" } },
{ $match: { temperature: { $gt: 50 } } },
{ $limit: 10 }
])
Limitations:
- Ephemeral only (no deployed processors)
- No billing (runs locally)
- Cannot test production connections
- Limited to simple pipeline validation
Recommended Action
For full Atlas Stream Processing capabilities, configure the MongoDB MCP Server with streams preview features enabled. The fallback options above provide minimal functionality and are not suitable for production workflows.