Skip to content
BENIBIX Learn

allowedMcpServers

AI⌨️ Claude CodeConfiguration

Also known as allowedMcpServers setting, MCP allowlist

A list of the only MCP servers people may add.

Think of it like

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

Example

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

Why it matters

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

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 code

json
{
  "allowedMcpServers": [
    { "serverName": "github" },
    { "serverUrl": "https://mcp.acme.com/*" }
  ]
}
Allow the github server and your own servers.
The deny list is checked first, then the allow list.

Common mistake

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

Key takeaways

  1. 1
    Only these load. Others blocked.
  2. 2
    Name, command or URL. One per entry.
  3. 3
    Empty blocks all. Unset allows all.

Compare