401 Unauthorized
Your token may be invalid or expired.
If using OAuth: Clear the cached authentication by running rm -rf ~/.mcp-auth in your terminal, then reconnect.
If using an API token: Create a new token in Settings > API Tokens and update your configuration.
OAuth login not opening
Your AI tool may not support OAuth for MCP. Use the API Token method instead. See [Connecting your AI coding assistant to InstilI] for setup instructions.
Connection timeout
Check your network connection. The Instill AI MCP server requires HTTPS. If you're behind a corporate firewall or VPN, ensure outbound connections to mcp.instill-ai.com are allowed.
Tools not appearing
Restart your editor after adding or updating the MCP configuration. Most AI tools only load MCP server tools at startup.
"disambiguation_required" message
This means you belong to multiple organizations. The MCP server needs to know which one to use. Specify the organization ID from the list provided in the response.
If you only want to work with one organization, simply tell your AI assistant which one to use and it will remember for the session.
External MCP server not connecting
Verify the server URL is correct and the server is running
Check the authentication method matches what the server requires
Look for a green dot next to the connection in Settings > MCP Servers — gray means disconnected.