Skip to main content
Gumloop supports connecting to any Model Context Protocol (MCP) server. This lets you extend your agents and workflows with specialized tools, internal services, or any MCP-compatible API.
Gumloop already has 50+ pre-built MCP servers for popular services like GitHub, Slack, Notion, HubSpot, and more. These work out of the box with agents and workflows. Browse available integrations before setting up a custom server.

​
Adding a Custom MCP Server

Setting up a custom MCP server takes just a few steps.
1

Go to Credentials

Navigate to Settings > Credentials and search for “MCP Server” in the available integrations.
Apps Available modal showing MCP Server option
2

Enter the Server URL

Click Add credential and enter your MCP server’s URL. The URL must use HTTPS.
MCP Server URL entry dialog
3

Configure Authentication

Fill in the server details:
FieldDescriptionRequired
LabelA unique name for this server (e.g., slack-mcp-server)Yes
Access Token / API KeyOAuth token or API key for authenticationIf required by server
Additional HeaderCustom header in Header-Name: value formatOptional
MCP Server credential configuration
4

Connect

Click Connect to save your credential. The server is now available to use in your agents and workflows.
Workspace vs Personal credentials: Credentials can be stored at the personal level (only you can use them) or workspace level (shared with your team). Choose the appropriate scope when setting up. learn more about credentials here

​
Requirements

Custom MCP servers must meet these requirements:
RequirementDetails
ProtocolHTTPS only (HTTP not supported)
AccessibilityMust be publicly accessible on the internet
TransportStreamable HTTP or Server-Sent Events (SSE)
Local serversNot supported (no STDIO or localhost connections)
Local MCP servers won’t work. Your server must be deployed to a publicly accessible URL. Services like Cloudflare Tunnels or ngrok can expose local servers if needed.

​
Authentication Options

Gumloop supports multiple authentication methods:
  • Bearer tokens: Standard OAuth/API key authentication
  • Custom headers: For services requiring specific header formats
  • OAuth discovery: Automatic OAuth flow discovery (RFC 8414) for compatible servers

​
Where You Can Use Custom MCP Servers

Once configured, your custom MCP servers can be used in two places: Agents and the Ask AI node.

​
Using MCP Servers with Agents

Agents offer the most flexible way to use custom MCP servers. The AI can discover all available tools and use them naturally in conversation.
1

Open Agent Configuration

Go to your agent’s settings and click Add tools.
2

Select MCP Server

Choose MCP Server as the tool type and search for your configured server under the Custom tab.
Selecting a custom MCP server in agent configuration
3

Use Your Agent

Your agent now has access to all tools from the MCP server. It will automatically discover and use them based on conversation context.
Why agents are more flexible:
  • Conversational context: The agent maintains conversation history and can use tools across multiple turns
  • Automatic tool selection: The agent chooses the right tool based on your request
  • Multi-server support: Connect multiple MCP servers and let the agent orchestrate between them
  • No workflow required: Use immediately in chat, Slack, or embedded interfaces

​
Using MCP Servers with Ask AI Node

For deterministic workflows, you can connect MCP servers to the Ask AI node.
1

Add Ask AI Node

Drag an Ask AI node onto your canvas.
2

Enable MCP

Click Show more options, then toggle Connect MCP Server? to ON.
3

Select Server(s)

Choose your configured MCP server(s) from the dropdown. You can select multiple servers.
Enabling MCP in Ask AI Node
When to use Ask AI node with MCP:
  • Building repeatable, production workflows
  • Need specific tool calls as part of a larger automation
  • Want to combine MCP tools with other Gumloop nodes

​
Comparison: Agents vs Ask AI Node

CapabilityAgentsAsk AI Node
FlexibilityHigh: conversational, multi-turnMedium: single prompt execution
Tool discoveryAutomaticAutomatic
Multi-serverYesYes
Best forInteractive use, complex reasoningWorkflows, batch processing
Approval promptsNot availableNot available

​
Supported Models

Custom MCP servers require models with native MCP support:
ModelProviderMCP Support
GPT-5OpenAI✅ Native
GPT-4.1OpenAI✅ Native
Claude 4 SonnetAnthropic✅ Native
Claude 3.7 SonnetAnthropic✅ Native
Other models won’t work with custom MCP servers. Only the models listed above support the MCP protocol natively. If you select an incompatible model, MCP tools will not be available.

​
Security Considerations

Information in your prompts may be sent to your MCP server. Be mindful of sensitive data and review your server’s data handling policies.
All tools exposed by your MCP server are immediately available to the AI. There are no approval prompts before tool execution. Use appropriate authorization scopes to limit access.
When using multiple MCP servers, consider that data retrieved from one server could be passed to another. Design your prompts accordingly.

​
Troubleshooting

IssueSolution
Cannot connectVerify URL is HTTPS and publicly accessible
Authentication failedCheck token validity and expiration
Tools not appearingEnsure the server implements MCP tool discovery
AI ignoring toolsBe more explicit in your prompt about which tools to use
Timeout errorsServer may be slow or unreachable. Check server status.
Test with discovery first. Ask your agent or Ask AI node to “list available tools” to verify the connection is working before building complex workflows.

​
Further Reading