What Are Claude Connectors? Data Access, Auth, Custom Setup, and Troubleshooting

TL;DR: Claude Connectors are MCP servers that give Claude access to external data. The Connectors Directory has 200+ integrations for Google Drive, Slack, Notion, Stripe, and more. You can add custom connectors via Settings. Auth uses OAuth. If you want to build an interactive Connector, sunpeak gives you a local Claude simulator and testing infrastructure.

What Are Claude Connectors?

Claude Connectors are MCP servers that extend what Claude can do. Without connectors, Claude only has access to the conversation and any files you upload. With connectors, Claude can reach into your tools and services: search your Google Drive, read your Slack messages, query your Stripe dashboard, pull Jira tickets, or access any API your connector exposes.

Each connector exposes tools that Claude can call. A Google Drive connector might expose a “search files” tool and a “read document” tool. A CRM connector might expose “find contact” and “update deal stage.” Claude decides when to call these tools based on your conversation, and the connector returns the data.

There are two types:

• Standard connectors return data that Claude formats into text. Claude decides how to present the information.
• Interactive connectors also render UI components (cards, dashboards, forms) directly in the conversation using MCP App resources. First-party interactive connectors include Figma, Canva, Asana, Slack, and Box.

What Data Can Claude Access Through Connectors?

Claude accesses whatever data the connector’s tools expose. The connector author decides what’s available by defining tool schemas and handlers. Here’s what the Connectors Directory currently offers:

Communication and collaboration: Slack (messages, channels, users), Gmail (emails, drafts), Notion (pages, databases), Asana (tasks, projects), monday.com (boards, items)

Files and documents: Google Drive (documents, spreadsheets, presentations), Box (files, folders), DocuSign (documents, envelopes)

Development: GitHub (repos, issues, PRs, code search), Jira (issues, sprints, boards), Linear (issues, projects)

Sales and CRM: Salesforce (contacts, deals, accounts), Apollo (prospecting, contacts), Clay (enrichment), Outreach (sequences)

Analytics and data: Stripe (payments, customers, subscriptions), SimilarWeb (traffic, analytics), FactSet (financial data), Hex (data notebooks)

Design: Figma (files, components, designs), Canva (designs, templates)

Custom connectors can access anything: internal databases, REST APIs, GraphQL endpoints, proprietary services, file systems. If your tool handler can reach it, Claude can use it.

All data transfers are encrypted. Anthropic stores encrypted OAuth tokens but does not store the actual data from your connectors.

Do Claude Connectors Need Auth?

It depends on the connector and how you’re using it.

Connectors Directory connectors that access private data use OAuth. When you enable one for the first time, you’ll be redirected to the service (Google, Slack, Stripe, etc.) to authorize access. After that, Claude can call the connector’s tools using your authorized credentials.

Custom connectors you add via Settings don’t require auth during development. If your MCP server is running on localhost (exposed via ngrok), Claude connects directly. If your custom connector needs to protect its endpoints, you can configure OAuth Client ID and Secret in the advanced settings when adding it.

For Connectors Directory submission, if your connector requires authentication, you must use OAuth. Pure client credentials flow (machine-to-machine without user interaction) is not supported. You also need to provide a test account for Anthropic’s reviewers. Both https://claude.ai/api/mcp/auth_callback and https://claude.com/api/mcp/auth_callback must be allowlisted as redirect URIs.

How to Add a Custom Connector to Claude

1. Run your MCP server. If it’s local, expose it with ngrok: ngrok http 3000
2. Go to Claude Settings > Connectors
3. Click the plus icon > “Add custom connector”
4. Enter your MCP server URL with the /mcp path (e.g., https://abc123.ngrok.app/mcp)
5. Save

That’s it. Your connector is now available in Claude conversations. Enable it per conversation via the + button in the message composer, or it may activate automatically when Claude determines it’s relevant.

Plan limits: Free Claude users can add one custom connector. Pro, Max, Team, and Enterprise plans support more. On Team and Enterprise plans, org admins must approve custom connectors first.

Claude Code and Connectors

Claude Code uses MCP servers directly rather than Claude Connectors. The same MCP server that powers a Claude Connector works with Claude Code, but the connection method is different.

In Claude Code, you configure MCP servers in your project settings or via the CLI rather than through the Connectors UI. If you’re building a connector with sunpeak, you can test it locally with the sunpeak simulator, and use the same MCP server URL in both Claude (via Connectors) and Claude Code (via MCP settings).

Troubleshooting: “Could Not Load Connectors Directory”

This error shows up when Claude can’t reach the Connectors Directory. Common causes and fixes:

1. Browser extensions are the most common cause. Ad blockers, privacy extensions, and script blockers can interfere with the requests Claude makes to load the directory. Disable extensions or try incognito mode.
2. Network issues. Corporate firewalls, VPNs, or DNS problems can block the connection. Try a different network or disable your VPN temporarily.
3. Service disruption. Check status.anthropic.com for ongoing incidents.
4. Browser cache. Clear your cache and reload. A stale cached response can cause this.
5. Try a different browser. If it works in Chrome but not Firefox (or vice versa), the issue is browser-specific, likely an extension or setting.

If none of these work, contact Anthropic support through the help menu in Claude.

Building a Claude Connector

If you want to build your own connector, sunpeak is an open-source Claude Connector framework that handles project scaffolding, local Claude simulation, testing, and deployment.

pnpm add -g sunpeak && sunpeak new

This creates a project with:

• src/resources/ for React components that render inside Claude
• src/tools/ for MCP tool handlers
• tests/simulations/ for mock data
• A local Claude simulator at localhost:3000

Run sunpeak dev, select Claude from the Host dropdown, and develop your connector locally. No paid Claude account needed. When you’re ready, deploy your MCP server and add it as a custom connector, or submit to the Connectors Directory.

The Claude Connectors tutorial walks through building a connector from scratch with full code examples.