# allowedMcpServers

> A list of the only MCP servers people may add.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** allowedMcpServers setting, MCP allowlist

## Think of it like

It is like a list of friends allowed into the house. Anyone not on it waits outside.

## Definition

allowedMcpServers is a settings key that lists the MCP servers people may add. Claude Code blocks any server not on it, wherever it is set up. That holds even for a plugin. Each entry names a server by name, command or URL. Left unset, every server is fine. An empty list blocks all the servers people add.

## Example

Emma's company only trusts two MCP servers. IT lists them, and a server someone finds online will not load.

## Example code

```json
{
  "allowedMcpServers": [
    { "serverName": "github" },
    { "serverUrl": "https://mcp.acme.com/*" }
  ]
}
```

Allow the github server and your own servers.

## Why it matters

An MCP server can read data and act for Claude, so each one is a door into your work.

## Common mistake

Thinking the allow list beats the deny list. A server on both is blocked.

## Three principles

- **Only these load.** Others blocked.
- **Name, command or URL.** One per entry.
- **Empty blocks all.** Unset allows all.

## Related terms

- [deniedMcpServers](https://learn.benibix.com/term/ai/denied-mcp-servers-setting)
- [allowManagedMcpServersOnly](https://learn.benibix.com/term/ai/allow-managed-mcp-servers-only-setting)
- [MCP Server](https://learn.benibix.com/term/ai/mcp-server)

## Told apart from

- [allowedMcpServers vs deniedMcpServers](https://learn.benibix.com/compare/allowed-mcp-servers-setting-vs-denied-mcp-servers-setting): People think the allow list wins when a server is on both. The deny list always wins, and it is checked first. The allow list is a list of the only servers that may load, while the deny list names the ones that never may. Deny lists from every file join, so anyone can block a server for themselves.

![How Claude Code checks an MCP server: the deny list is checked first and always wins, then the allow list, if one is set, must name it.](https://learn.benibix.com/diagrams/mcp-server-allow-deny.svg)

---

Source: https://learn.benibix.com/term/ai/allowed-mcp-servers-setting
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
