Troubleshooting
If you encounter issues while setting up or using the Port MCP Server, expand the relevant section below:
How can I connect to the MCP? (Click to expand)
Refer back to the setup instructions for your specific application (Cursor, VSCode, or Claude). Make sure you're using the correct regional URL for your Port organization.
I completed the connection but nothing happens (Click to expand)
Check that you've followed all the setup steps correctly for your application. Ensure you're authenticated with Port and have the necessary permissions. If you've followed all the steps and still have issues, please reach out to our support team.
Why do I see an error about too many tools? (Click to expand)
Each self-service action in your Port instance becomes an individual tool (as run_<action_identifier>). If your organization has many actions, this can result in a large number of tools being available.
While most AI models handle this well, some have restrictions and may limit you to around 40 tools total. If you encounter errors about tool limits:
- Reduce the number of tools by customizing which tools are enabled (see Select which tools to use section above)
- Focus on essential tools by only enabling the read-only tools you need plus a few key actions
- Contact your Port Admin to review which actions are essential for your workflow
This is completely normal behavior and doesn't indicate a problem with Port MCP - it's just a limitation of some AI models.
If you continue to experience issues, please reach out to Port support with:
- Your IDE/application version
- The specific error messages you're seeing
- Your Port region (EU/US)
- Steps you've already tried
This information will help us provide more targeted assistance.