from line 1
11# Connectors
22
3> Add Model Context Protocol servers for your own systems, choose which Claude products receive each one, and set which of their tools are available to members.
3> Connectors let tenant administrators and organization owners add their agency's MCP servers: who gets them, authentication, OAuth redirect URIs, tool policy.
44
55> **Who this is for:** Tenant administrators and organization owners who want Claude to reach their agency's own systems (for example, an internal search service or a ticketing tool) from Claude Desktop and other Claude products.
66
7Use this page to add Model Context Protocol servers for your own systems, choose which Claude products receive each one, and set which of their tools are available to members.
7Use this page to add Model Context Protocol (MCP) servers for your own systems, choose which Claude products receive each one, and set which of their tools are available to members.
88
9A **connector** is a link between Claude and an external service. The service runs a Model Context Protocol (MCP) server, which is a standard way for a service to publish a set of tools that Claude can call. You add the server once here, and Claude for Government delivers it to the products you select.
9A **connector** is a link between Claude and an external service. The service, your agency's own or a vendor's, runs an MCP server, which is a standard way for a service to publish a set of tools that Claude can call. You add the server once here, and Claude for Government delivers it to the products you select.
1010
11<video controls preload="metadata" playsInline src="https://mintcdn.com/claude-ai/gGFKuNSbKYs4JMmK/images/government/videos/admin-07-connectors-and-plugins.mp4?fit=max&auto=format&n=gGFKuNSbKYs4JMmK&q=85&s=43f78d15928eea46d27229f8dbc04db6" aria-label="Video walkthrough: Connectors and plugins" />
12
13Video: Connectors and plugins (2 min 8 s). Narrated with an AI-generated voice, with on-screen captions.
14
15> [accordion] Transcript
11> [!NOTE]
1612>
17> A connector lets Claude reach another service, such as Microsoft 365 or a system of your own. A plugin packages skills and commands for Claude Desktop.
13> These cases are covered on other pages:
1814>
19> Microsoft 365 setup starts in Microsoft Entra. An Entra administrator registers an application, approves its Microsoft Graph permissions, and sends you two values, the tenant ID and the client ID.
20>
21> On Config, under Integrations, expand Microsoft 365. Paste the Tenant ID and the Client ID, keep Azure cloud on Commercial unless your Microsoft tenant is in GCC High or DoD. Check that Access matches what Entra approved, and save.
22>
23> Members then connect Microsoft 365 in Claude Desktop with their own work account, and Claude reaches only what each member can already open.
24>
25> For a system of your own, open Add connector on the Connectors card. Name it, enter the server's address, and choose how Claude authenticates, for example a shared secret or member sign-in. Select Next.
26>
27> Discover tools asks the server which tools it offers. If the server cannot be reached from your browser, add tool names by hand on the next step.
28>
29> Under Apply to, choose the products that receive it, here Claude Desktop only. Under Tool policy, switch off any tool you do not want, then save the connector. Members are still asked before Claude uses an allowed tool.
30>
31> On the Plugins card, select Add plugins and drop a zip file. The preview shows its name and version. Choose Auto-install for everyone, or Members choose, then add it.
32>
33> You do not need to push anything. Claude Desktop picks up the connector and the plugin when it next checks for changes. Members find plugins under Customize, Plugins.
15> * **The Microsoft 365 connector**: see [Set up the Microsoft 365 connector](https://claude.com/docs/government/connectors/microsoft-365.md)
16> * **Plugins**: see [Manage plugins and connectors](https://claude.com/docs/government/config/plugins-and-connectors.md)
3417
35## The Connectors card
18<video controls preload="metadata" playsInline src="https://mintcdn.com/claude-ai/gGFKuNSbKYs4JMmK/images/government/videos/admin-07-connectors-and-plugins.mp4?fit=max&auto=format&n=gGFKuNSbKYs4JMmK&q=85&s=43f78d15928eea46d27229f8dbc04db6" aria-label="Video walkthrough: Connectors and plugins" />
3619
37The **Connectors** card appears on your [tenant](https://claude.com/docs/government/tenant-admin/configuration.md) or [organization](https://claude.com/docs/government/org-admin/configuration.md) Config page alongside the built-in connector cards, and on the Config page for each [directory group](https://claude.com/docs/government/config/overview.md#group-specific-settings). It lists the connectors added at the level you are viewing and the connectors that level inherits, with each one's name, address, the products it applies to, and a summary of how many of its tools are allowed. Click **Add connector** to open the wizard, or click the edit icon next to a connector added at this level to change it.
20Video: Connectors and plugins (2 min 8 s). Narrated with an AI-generated voice, with on-screen captions.
3821
39An inherited connector has a badge that says where it comes from, such as **Inherited from your tenant** or **Inherited from your organization**, in place of the edit and remove controls. To change an inherited connector for the members at your level, click **Add connector** and create one with the same name. The inherited connector's details and stored secret are not copied, so you enter the server address and authentication again. Your entry then replaces the inherited one in the list and takes priority over it, as described under [Who receives a connector](#who-receives-a-connector).
22[Transcript](https://claude.com/docs/government/video-walkthroughs.md#connectors-and-plugins)
4023
4124## Who receives a connector
4225
43Who receives a connector depends on where you add it:
26To see or add connectors, go to **Settings > Config** and open the **Connectors** card, under **Integrations**. A connector reaches the people whose settings you are editing when you add it: everyone in the [tenant](https://claude.com/docs/government/tenant-admin/configuration.md), everyone in an [organization](https://claude.com/docs/government/org-admin/configuration.md), or the members of one directory group, as described under [Group-specific settings](https://claude.com/docs/government/config/overview.md#group-specific-settings). In every case it is delivered only to the products you select, with the tool policy you set.
4427
45* On the tenant Config page, it reaches the members of every organization in the tenant.
46* On an organization's Config page, it reaches every member of that organization.
47* On the Config page for a [directory group](https://claude.com/docs/government/config/overview.md#group-specific-settings), it reaches that group's members: in every organization when you open the group from the tenant Config page (a tenant-wide group setting), or only in one organization when you open the group from that organization's Config page (an organization group setting).
28A connector added for a group does not always reach every member of the group. Only one group's settings, connectors included, apply to each person, as described under [When someone belongs to more than one group](https://claude.com/docs/government/config/overview.md#when-someone-belongs-to-more-than-one-group).
4829
49In every case it is delivered only to the products you select, with the tool policy you set.
30When the same connector name is added at more than one level, each member receives only the entry from the [most specific level](https://claude.com/docs/government/config/overview.md#how-settings-are-applied) that applies to them. That entry replaces the others as a whole, including its address, authentication, products, and tool policy.
5031
51When the same connector name is added at more than one level, each member receives only the entry from the most specific level that applies to them: the organization's group settings first, then the organization, then the tenant-wide group settings, then the tenant. That entry replaces the others as a whole, including its address, authentication, products, and tool policy. You cannot remove a connector inherited from a level above, but you can stop it from reaching the members at your level by adding one with the same name and selecting no products under **Apply to**.
32### Change or stop an inherited connector
5233
53A connector added for a group does not always reach every member of the group. Someone who belongs to more than one directory group receives group settings, connectors included, from only one of them: their [highest-priority group](https://claude.com/docs/government/config/overview.md#when-someone-belongs-to-more-than-one-group) that has any configuration. Adding a group's first connector or deleting its last one can therefore change which group, and so which group settings, apply to some members. The group's Config page shows a note when this could happen. To check which group applies to a particular member, use the person lookup described under [Comparing settings across levels](https://claude.com/docs/government/config/overview.md#comparing-settings-across-levels).
34Unless a level above has [locked](https://claude.com/docs/government/config/overview.md#locks) the **Connectors** card, you can change an inherited connector for the members at your level: click **Add connector** and create one with the same name. The inherited connector's details and stored secret are not copied, so you enter the server address, authentication, and tool policy again. You cannot remove a connector inherited from a level above, but in the same way you can stop it from reaching the members at your level: add one with the same name and select no products under **Apply to**.
5435
5536## Adding a connector
5637
57The **Add connector** button opens a three-step wizard.
38Go to **Settings > Config**, open the **Connectors** card, and click **Add connector**. On the tenant Config page, you first choose whether organizations **May set their own value** or **Must use this value**, which stops organizations and groups from adding connectors or replacing yours.
5839
59### Step 1: Server
40### Server address and authentication
6041
61Enter the details of the MCP server.
62
63* **Name** is a short identifier for the connector. It must be lowercase letters, digits, hyphens, or underscores.
64* **Server URL** is the address of the server's MCP endpoint. It must begin with `https://`.
42* **Name** is a short identifier for the connector. It must be letters a to z in either case, digits, hyphens, or underscores. Claude Desktop shows members [the name](https://claude.com/docs/third-party/claude-desktop/configuration.md#managedmcpservers) with the capital letters you type. If you add a connector with a name already used at your level, even with different capital letters, the new connector replaces that one, tool policy included.
43* **Server URL** is the address of the server's MCP endpoint. It must begin with `https://`. Enter the address the server answers on, not one that redirects to it. Claude Desktop [connects to it directly from each member's device](https://claude.com/docs/government/security/security-and-data-handling.md#connectors), so the server, and its sign-in provider if it uses OAuth, must be reachable from those devices. You do not need to ask Anthropic to allow either address.
6544* **Transport** selects how Claude talks to the server. Choose HTTP or SSE to match what your server supports.
66* **Authentication** selects how Claude proves who it is to the server. **None** sends no credentials. **Header (shared secret)** sends a fixed header (for example, an authorization token) with every request; the value is stored securely and shown as `••••` after you save. **OAuth (members sign in)** has each member sign in on first use, and their tokens stay on their own machine. **OAuth (pre-registered app)** also has each member sign in, through an app you register with the server's sign-in provider ahead of time.
45* **Authentication** selects how Claude proves who it is to the server:
46 * **None** is for a server that needs no sign-in: it sends no credentials. If the server asks for sign-in anyway, Claude Desktop [lets each member sign in](https://claude.com/docs/third-party/claude-desktop/extensions.md#oauth-sign-in).
47 * **Header (shared secret)** sends a fixed header (for example, an authorization token) with every request; the value is stored securely and shown as `••••` after you save, and each member's app receives it.
48 * **OAuth (members sign in)** has each member sign in on first use, and their tokens stay on their own machine. Choose it when the server's sign-in provider lets apps register themselves (dynamic client registration).
49 * **OAuth (pre-registered app)** also has each member sign in, through an app you register with the server's sign-in provider ahead of time. Choose it when the provider has you create an app and copy its client ID.
6750
68For **OAuth (pre-registered app)**, enter the **Client ID** your provider issued when you registered the app. A single-tenant Microsoft Entra app also needs its **Tenant ID** and the **Scope** the app requests. Enter the scope that your server's own API expects (for example, an `api://` scope for an app registered in your tenant), because Microsoft Graph scopes such as `Mail.Read` would give the connector's server access to members' Microsoft 365 data. Neither OAuth option stores a secret.
51Neither OAuth option stores a secret. If the server's sign-in provider requires a client secret, members can't connect to that server.
6952
70**OAuth (pre-registered app)** also has two optional fields:
53When you choose either OAuth option, a confirmation checkbox appears on the final step asking you to confirm that the server address is exactly the one you intend, because members are sent to a sign-in page that the server chooses. When sign-in happens somewhere other than the server itself, for example when you set a tenant ID for a Microsoft Entra app, the checkbox names both that sign-in address and the server address.
7154
72* **Callback port**: if your sign-in provider requires the exact port in the app's registered redirect URI, enter that port
73* **Callback host**: if the app's registered redirect URI uses `localhost` rather than `127.0.0.1`, select **localhost**
55### Register an app for sign-in
7456
75When you choose either OAuth option, a confirmation checkbox appears on the final step asking you to confirm that the server address is exactly the one you intend, because members are sent to a sign-in page that the server chooses. When sign-in happens somewhere other than the server itself, for example when you set a tenant ID for a Microsoft Entra app, the checkbox names both that sign-in address and the server address.
57For **OAuth (pre-registered app)**, add Claude Desktop's [redirect URI](https://claude.com/docs/third-party/claude-desktop/extensions.md#oauth-sign-in), `http://127.0.0.1:53280/callback`, to the app's registration with your sign-in provider. If the registration uses another port or `localhost`, set **Callback port** or **Callback host** in the wizard to match. Have the app's client ID ready, and for a single-tenant Microsoft Entra app its tenant ID and scope as well.
7658
77### Step 2: Discover tools
59For the Claude Code command-line tool, set **Callback port** to the port you registered for Claude Desktop. Also add `http://localhost:PORT/callback`, with that port, to the registration. A connector with a tenant ID is not delivered to the command-line tool.
7860
79This step tries to list the tools the server offers so that you can set policy on the next step. Discovery runs from your own browser and is best-effort; many servers cannot be reached this way (for example, because they require authentication or are on a private network), and you can always add tools by name on the next step instead.
61Enter the scope that your server's own API expects (for example, an `api://` scope for an app registered in your tenant), because Microsoft Graph scopes such as `Mail.Read` would give the connector's server access to members' Microsoft 365 data.
8062
81Click **Discover tools** to run the probe. If the server answers, the tools it advertises are listed. If the server asks for sign-in, a **Sign in to discover** option appears: confirm the sign-in host, sign in through the popup, and the probe runs again with that one-time credential. The credential is used once in your browser for this probe and is never stored; it is separate from the **Authentication** choice on the Server step, which controls how members authenticate later.
63### Tool discovery
8264
83The **Sign in to discover** option does not appear when you choose **OAuth (pre-registered app)**, because this probe does not sign in with the app you registered. Add the tools by name on the next step.
65The wizard tries to list the tools the server offers, so that you can set policy on them. Discovery runs from your own browser and is best-effort; many servers cannot be reached this way (for example, because they require authentication or are on a private network), and you can always add tools by name on the next step instead.
8466
85### Step 3: Policy & scope
67Discovery can ask you to sign in to the server. The credential is used once in your browser for this probe and is never stored; it is separate from the **Authentication** choice on the Server step, which controls how members authenticate later.
8668
87Choose which products receive this connector and which of its tools are available.
69### Products and tool policy
8870
89Under **Apply to**, tick the products that should receive this connector. A connector with no products ticked is saved but delivered nowhere, which is a way to pause it. A connector that uses OAuth cannot be applied to Microsoft 365, because per-user sign-in is not available there. A connector with any tool switched off in the table below also cannot be applied to Microsoft 365, and the checkbox is disabled with a **needs every tool on** note until every tool is on. A connector that uses **OAuth (pre-registered app)** with a **Tenant ID** is not delivered to the Claude Code command-line tool, and its checkbox shows a **not delivered to the Claude Code command-line tool** note.
71Under **Apply to**, tick the products that should receive this connector. **Microsoft 365** is the [Claude for Microsoft 365 add-in](https://claude.com/docs/government/deploy-microsoft-365/configure.md#before-you-begin), which cannot receive a connector that uses OAuth or that has any tool switched off.
9072
91Under **Tool policy**, the table lists the tools found during discovery with an on/off switch for each. **Refresh tools** probes the server again and fills in any tools that are new since you last looked, keeping the switches you have already set. **Add tool** lets you type a tool name by hand when discovery could not reach the server.
73Under **Tool policy**, switch each of the server's tools on or off, or leave it unlisted. On Claude Desktop, that tool policy shapes what members experience:
9274
93On Claude Desktop, a tool you switch off is blocked, a tool you switch on is available and each member still approves its use, and a tool that is not listed at all is left to the member to enable or disable. You cannot apply this connector to Microsoft 365 while any tool in this table is switched off. If you are editing a connector that already applies to Microsoft 365 and you switch a tool off, a warning tells you that saving will remove it from Microsoft 365.
75* A tool you switch off is blocked, so Claude cannot use it.
76* A tool you switch on is available and asks the member on every use, and members are not offered a lasting approval for it. Its permission control is locked, and hovering over it shows **Permission set by your admin**.
77* A tool you do not list is left to the member to turn on or off, and its approval prompts follow the member's own choices, which can include lasting approval. To return a listed tool to each member's control, remove its row.
9478
95Click **Save** to create the connector. It appears in the **Connectors** card and is delivered to the products you ticked.
79A saved connector reaches members as described under [When changes take effect](https://claude.com/docs/government/config/overview.md#when-changes-take-effect).
9680
81### Connection to server failed
82
83If **Connect** in Claude Desktop shows "Connection to server failed. You can try again.", check first that the device can reach the server's address, that the app you registered lists the redirect URI, and that no other program is using the callback port. When the provider doesn't list the redirect URI, its own error page opens in the member's browser. In the other two cases the member's [`main.log`](https://claude.com/docs/government/deploy-desktop/configure#troubleshooting) records the reason. [How OAuth sign-in works](https://claude.com/docs/third-party/claude-desktop/extensions.md#how-oauth-sign-in-works) lists other causes.
84
9785## Editing and removing a connector
9886
99Click the edit icon next to a connector in the card to open the same wizard with its current values filled in. Changing the authentication method clears any stored secret and the app details saved for **OAuth (pre-registered app)**. Click the remove button next to a connector to delete it; it is withdrawn from every product at the next refresh. If you delete a connector that takes priority over an inherited connector with the same name, the inherited connector applies again from that refresh.
87To change a connector, edit it on the **Connectors** card. Changing the authentication method clears any stored secret and the app details saved for **OAuth (pre-registered app)**.
88
89Click the remove button next to a connector to delete it; it is withdrawn from every product [when the change takes effect](https://claude.com/docs/government/config/overview.md#when-changes-take-effect). If you delete a connector that takes priority over an inherited connector with the same name, the inherited connector applies again.
10090