Skip to main content

​
Overview

Add your Barndoor ToolIQ endpoint found here OR for your Trial found here to your favorite chat client. If you’re not already logged in, you’ll be redirected to Barndoor to authenticate and authorize the MCP servers you want to access.
If you ever want to see what servers you’re connected to, [click here](https://app.barndoor.ai/settings/accounts OR for your Trial found here.

​
Connect Your Chat Client

Select your preferred AI chat client below to see detailed connection instructions:
Claude AI

Prerequisites:

  • Active Claude account (Pro or Team plan recommended)
  • Universal Barndoor URL

Connection Steps

Follow the official guide for connecting to remote MCP servers for step-by-step instructions.
1

Admin Settings

Click on your profile icon in the bottom left corner and select Settings.
2

Navigate to Integrations

Go to the Connectors tab in settings
3

Add MCP Server

Click “Add custom connector” at the bottom of the section.
4

Configure Connection

Enter your MCP server details:
  • Server Name: A friendly name for your server
  • Server URL: Your MCP server endpoint (e.g., https://{{your-org}}.mcp.barndoor.ai.com/mcp)
5

Connect

Click Connect to authorize Barndoor Platform
6

Use in Conversations

Start a new conversation and Claude will automatically have access to your MCP server’s tools and data
You can enable or disable specific MCP servers for individual conversations using the tools menu in the chat interface.
ChatGPT

Prerequisites:

  • ChatGPT Plus or Enterprise account
  • MCP server OpenAPI schema

Custom GPT with Actions

Follow the official guide for connecting to remote MCP servers.
1

Create Custom GPT

Go to ChatGPT and navigate to Settings → Apps → Create App.
2

Provide the metadata for your App

  • Name – a user-facing title such as Kanban board.
  • Description – explain what the connector does and when to use it. The model uses this text during discovery.
  • MCP server URL – the public /mcp endpoint of your server (for example https://abc123.ngrok.app/mcp).
3

Test & Publish

Click Create. If the connection succeeds you will see a list of the tools your server advertises. If it fails, refer to the Testing guide to debug your app with MCP Inspector or the API Playground.
Cursor IDE

Prerequisites:

  • Cursor IDE installed
  • MCP server URL and API key
1

Open Settings

Go to Cursor → Settings (or Cmd/Ctrl + ,)
2

Find MCP Configuration

Navigate to Extensions → MCP or search for “MCP” in settings
3

Add Server

Click Add MCP Server and configure:
{
  "mcpServers": {
    "{{your-org}}.mcp.barndoor.ai": {
      "url": "https://{{your-org}}.mcp.barndoor.ai.com/mcp"
    }
  }
}
4

Restart Cursor

Restart Cursor to apply changes
VS Code

Prerequisites:

  • Visual Studio Code installed
  • VS Code version with MCP support enabled

Connection Steps

1

Open VS Code Settings

Open the Command Palette (Cmd/Ctrl + Shift + P) and select Preferences: Open Settings (JSON).
2

Configure MCP Server

Add your MCP server configuration to settings.json:
{
  "mcp.servers": [
    {
      "name": "Your Server",
      "url": "https://{{your-org}}.mcp.barndoor.ai/mcp"
    }
  ]
}
3

Authenticate

Authorize Barndoor and Sign in when prompted.
4

Reload Window

Reload VS Code to activate the MCP connection.

​
Troubleshooting

  • Verify your server URL is correct and accessible
  • Check that authentication credentials are valid
  • Ensure your MCP server is running and responding to requests
  • Check firewall settings if using a self-hosted server
  • Confirm the MCP server is properly registered
  • Verify the server’s tools are correctly defined in its schema
  • Try disconnecting and reconnecting the server
  • Clear cache and restart the client application
  • Double-check API keys or tokens
  • Verify authentication method matches your server’s requirements
  • Check if tokens have expired and need renewal
  • Ensure proper scopes/permissions are granted

​
Security Best Practices

Never share your MCP server credentials publicly or commit them to version control.
  • Use environment variables for sensitive credentials
  • Implement proper authentication and authorization
  • Use HTTPS for all MCP server connections
  • Regularly rotate API keys and tokens
  • Monitor Barndoor server logs