Market
Pricing
Sign inStart
Field GuideAI and design
AI and design

Claude connectors: what they are and how to add one

A connector gives Claude hands: it can search your files, read a project or make a design in a real tool, rather than describing how you might. Here is how they work and how to add one in a few minutes.

GradientlyVerified Gradiently account·October 1, 2026·5 min read
Cover: Chamomile Springs · GR·XM1Q·AT

The short version

  • Claude connectors link Claude to outside services so it can search, read and act in them during a conversation.
  • Connectors are built on the Model Context Protocol, an open standard for connecting AI assistants to tools and data.
  • Remote connectors run on the web and are added by URL or from a directory, while local servers run on your own computer.
  • Claude asks for permission before using a connector's tools, and you can allow an action once or always.
  • Which connector features you can use depends on your Claude plan and, in organisations, on what an owner has enabled.
On this page
How connectors workHow to add a connector from the directoryHow to add a custom connectorAdding an MCP server in Claude CodeAn example: Claude making designsKeeping connectors safeTroubleshooting a connector

Claude connectors link Claude to outside services so that, during a chat, it can search them, read from them and take actions in them, such as creating a document or a design. Each connector is an MCP server: a small web service that speaks the open Model Context Protocol and tells Claude which tools it offers. You add one from Claude's connector directory or, for a custom connector, by pasting the server's URL in Claude's settings, then sign in to the service and choose what Claude may do there.

How connectors work

When a connector is enabled, Claude receives a list of its tools, each with a name, a description and the inputs it needs. When your request fits one, Claude fills in the inputs and asks your permission to run it. The service does the work and sends back a result, which Claude reads and uses in its reply. The specification and a list of example servers live at modelcontextprotocol.io, and what is MCP explains the idea in plain words.

Directory connector

Where it runs

On the service's servers

How you add it

Pick it from Claude's list and sign in

Typical use

Popular apps and file stores
Custom remote connector

Where it runs

On the web, at a URL

How you add it

Paste the server URL in settings

Typical use

Any service with an MCP server
Local server

Where it runs

On your own computer

How you add it

A desktop extension or a config file

Typical use

Files and apps on your machine
Claude Code server

Where it runs

Local or remote

How you add it

claude mcp add in the terminal

Typical use

Development and automation
TypeWhere it runsHow you add itTypical use
Directory connectorOn the service's serversPick it from Claude's list and sign inPopular apps and file stores
Custom remote connectorOn the web, at a URLPaste the server URL in settingsAny service with an MCP server
Local serverOn your own computerA desktop extension or a config fileFiles and apps on your machine
Claude Code serverLocal or remoteclaude mcp add in the terminalDevelopment and automation
Four ways Claude connects to tools. Remote connectors are the easiest to share and keep up to date.

How to add a connector from the directory

  1. 1

    Open connector settings

    In Claude on the web or the desktop app, open Settings and find Connectors.

  2. 2

    Browse the directory

    Pick the service you want. Each listing explains what the connector can access.

  3. 3

    Connect and sign in

    Claude sends you to the service to sign in and approve access, then returns you to Claude.

  4. 4

    Enable it in a chat

    In a conversation, turn the connector on from the tools menu. Leave unused connectors off so Claude chooses from fewer tools.

How to add a custom connector

A custom connector is any remote MCP server that isn't in the directory, including ones from smaller tools or your own company. In Settings, under Connectors, choose to add a custom connector, give it a name and paste the server's URL. If the server uses sign in, Claude walks you through it. On Team and Enterprise plans, an owner may need to add or allow the connector for the organisation first. Anthropic's Claude help centre has the current steps for each plan, and it is worth checking, because the menus change.

Some servers use API keys

Not every server signs in through a browser. Some expect an API key sent in an Authorization header. If your Claude app's connector form has nowhere to put one, use Claude Code, or follow the service's own setup guide.

Adding an MCP server in Claude Code

Claude Code adds servers from the terminal, and it can send a custom header, which makes it the simplest route for servers that use API keys. Keep the key in an environment variable so it never sits in your shell history or a shared file.

bash
# A remote server that signs in through the browser
claude mcp add --transport http example https://example.com/mcp

# A remote server that expects an API key
claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
  --header "Authorization: Bearer $GRADIENTLY_API_KEY"

# Check what is connected
claude mcp list
Adding remote servers to Claude Code. Replace the example URL with the server you want.

An example: Claude making designs

Design shows what a connector changes. On its own, Claude can suggest a headline and describe a layout. Connected to Gradiently, it can search Marks, read your brand and create designs that open in the Studio, ready for you to check and export. A workspace owner or admin creates a scoped API key in Gradiently under Settings › API and agents, choosing exactly what the assistant may do, and the developer docs cover setup. Designs the assistant makes this way spend no Gradiently credits.

From this week
Late opening on Fridays.
Open until midnight, kitchen until eleven
Gradiently · @gradiently

A story Claude made from one sentence through a design connector: real text, the brand's Mark, the exact 1080×1920 frame.

Designing with Claude through Gradiently walks through a full conversation, from one story to three formats.

Keeping connectors safe

Avoid

  • Custom connectors from sources you can't verify
  • Choosing "always allow" for actions that delete or spend
  • One key with every permission, shared everywhere
  • Leaving every connector on in every chat

Do

  • Servers published by the service itself
  • Allow once until you trust a tool's behaviour
  • One scoped key per place, named after it
  • Enable only the connectors a chat needs

A connector can read what Claude sends it and act with the access you granted. Content a connector fetches, such as a web page or a shared file, can also contain instructions, so read what Claude proposes to do next rather than approving on autopilot.

Troubleshooting a connector

Connector added, no tools appear

Likely cause

Not enabled in this chat

Try

Turn it on from the tools menu
Unauthorised or 401 error

Likely cause

Missing or revoked key or sign in

Try

Reconnect, or create a new key
Claude ignores the connector

Likely cause

Request doesn't match a tool

Try

Name the service and the outcome in your message
Option to add custom connectors missing

Likely cause

Plan or organisation settings

Try

Ask your Claude organisation owner, or check the help centre
SymptomLikely causeTry
Connector added, no tools appearNot enabled in this chatTurn it on from the tools menu
Unauthorised or 401 errorMissing or revoked key or sign inReconnect, or create a new key
Claude ignores the connectorRequest doesn't match a toolName the service and the outcome in your message
Option to add custom connectors missingPlan or organisation settingsAsk your Claude organisation owner, or check the help centre
Four common problems when adding a connector.

ChatGPT has a similar system, described in ChatGPT apps, connecting an AI assistant covers Gradiently in several clients, and MCP servers for designers suggests which kinds to connect first.

Connect your AI assistant

Let Claude or any MCP client search Marks and make designs that open in the Studio.

Read the developer docs

Questions people ask

What are Claude connectors?

Integrations that let Claude search, read and act in outside services during a chat. Each one is an MCP server that offers Claude a set of tools.

How do I add a custom connector to Claude?

Open Settings, go to Connectors, choose to add a custom connector and paste the remote MCP server's URL, then sign in if asked. Some plans need an owner to allow it first.

What is the difference between a local and a remote MCP server?

A local server runs on your computer and can reach your files and apps. A remote server runs on the web at a URL, so it works from any device.

Can Claude make designs with a connector?

Yes, with a design tool that offers an MCP server. Gradiently lets Claude create designs in your brand that open in its Studio for editing.

Share this guide

Written by GradientlyVerified Gradiently account

The team behind Gradiently, a design tool built around Marks: living gradients that make everything you design look like yours.

See our profile

On this page

How connectors workHow to add a connector from the directoryHow to add a custom connectorAdding an MCP server in Claude CodeAn example: Claude making designsKeeping connectors safeTroubleshooting a connector

Share this guide

Next in AI and design

MCP servers for designers: AI assistants that use real tools

Keep reading

All AI and design guides
AI and design

What is MCP? Letting your AI assistant use real tools

6 min read

An AI assistant that can only talk is limited to advice. One that can use your tools can actually do the work. MCP is the standard that connects the two.

AI and design

Claude design: making on-brand visuals with Gradiently

5 min read

Claude is good at understanding what you mean. Connected to Gradiently, it can also make it: real, editable designs in your brand, waiting in the Studio for your final touch.

Using Gradiently

Gradiently MCP: connect Claude, ChatGPT or any MCP client

6 min read

Gradiently speaks MCP, so an AI assistant can search Marks, read your brand and make designs that open in your Studio. Here is the setup in plain language, and how to keep it safe.

Find the look that’s only yours.

Every Mark is a living background with one owner. Try an unclaimed Mark, and claim yours when it feels right.

Start designing

Check a certificate

Type a certificate number or a Mark’s code to see who owns it.

Works with ChatGPT and Claude

Ask your AI for a design. It makes it in your Mark, ready to edit.

ChatGPTClaude
How to connect

Product

  • Market
  • Explore
  • Pricing
  • Certificates

Learn

  • Field Guide
  • Help centre
  • What’s new

Developers

  • Overview
  • ChatGPT and Claude
  • API reference
  • API keys

Company

  • About
  • Contact us
  • Sign in

Legal

  • Terms
  • Privacy
  • Refunds
  • Mark protection
  • Cookies
  • All policies
Move through the letters. Each one wears a real Mark.Touch a letter to see its Mark.One name. Ten Marks inside it.
© 2026 Gradiently