Connect AI clients to Barndoor - Barndoor Documentation

Overview

Add your Barndoor ToolIQ endpoint 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.

Connect Your Chat Client

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

Claude

Prerequisites:

Connection Steps

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

  1. Open Settings Navigate to Settings > Connectors.

  2. Add Custom Connector Click “Add custom connector” at the bottom of the Connectors section.

  3. Configure Connection Enter your MCP server URL (e.g., https://{{your-org}}.platform.barndoor.ai/mcp). Optionally, click “Advanced settings” to provide an OAuth Client ID and OAuth Client Secret for your server.

  4. Finish Click “Add” to save your connector.

  5. Use in Conversations Start a new conversation — Claude will have access to your connector’s tools and data.

Only Owners can add custom connectors to a Team or Enterprise organization. Members connect individually after an Owner has added the connector.

  1. Open Organization Settings Navigate to Organization Settings > Connectors.

  2. Add Custom Connector Click “Add custom connector” at the bottom of the Connectors section.

  3. Finish Click “Add” to make the connector available to your organization’s members.

Your Owner must add the custom connector to your organization before you can connect to it.

  1. Open Settings Navigate to Settings > Connectors.

  2. Find the Connector Locate the custom connector your Owner added — it will have a “Custom” label.

  3. Connect Click “Connect” to authenticate and start using the connector with Claude.

  4. Use in Conversations Start a new conversation — Claude will have access to your connector’s tools and data.

You can enable or disable specific connectors for individual conversations using the tools menu in the chat interface.

ChatGPT

Prerequisites:

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:

  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}}.platform.barndoor.ai": {
      "url": "https://{{your-org}}.platform.barndoor.ai/mcp"
    }
  }
}

  4. Restart Cursor Restart Cursor to apply changes.

VS Code

Prerequisites:

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}}.platform.barndoor.ai/mcp"\
    }\
  ]
}

  3. Authenticate Authorize Barndoor and Sign in when prompted.

  4. Reload Window Reload VS Code to activate the MCP connection.

Troubleshooting

Connection Failed

Tools Not Appearing

Authentication Errors

Security Best Practices

Never share your MCP server credentials publicly or commit them to version control.