How to connect the magnews MCP server to Claude Code – magnews Help Center

The magnews MCP server allows you to use magnews resources directly from Claude Code through natural language requests.

In practice, you can search communications, analyze workflows, retrieve HTML content, view insights, and make targeted changes without constantly switching between the platform, APIs, and different technical tools.

What is MCP

MCP (Model Context Protocol) is a standard that allows an AI assistant to use external tools in a structured way.

In the case of magnews:

Claude Code is the MCP client
magnews is the MCP server

This means you can work with magnews resources using natural language requests, without having to manually build queries or API calls.

Example interaction from Claude Code:

“Which workflows are currently active and how many contacts have they processed in the last 30 days? Highlight the ones with an error rate above 2%.”

Claude performs multiple consecutive calls to the available tools, retrieves the required data, and directly returns the final result by combining the outputs.

Configuration

1. Add `magnews` with a command

The fastest way is to use the Claude Code CLI:

claude mcp add --transport http magnews https://mcp-mn1.mag-news.it/mcp/stream \
  --header "Authorization: Bearer <YOUR_TOKEN>"

2. Get the token

To generate a token in magnews, go to Settings > APIs and integrations > Digital certificates and click Connect MCP server (if you have not already enabled it previously).

Then, in the same section, under Token management, generate a new token for the MCP Server digital certificate, selecting the user you want to use to perform requests on magnews from Claude.

⚠️ The token grants access to your magnews account. Do not share it and do not commit it to any repository.

3. Manual configuration (alternative)

The claude mcp add command automatically writes the configuration to the correct file depending on the selected scope: --scope user to make it available across all your projects, --scope project to share it with the team through the repository, or --scope local to limit it to a specific project on a specific machine.

In general, using the command is recommended. This section is only useful if you want to understand where the configuration is stored or manually manage multiple environments.

Depending on the scope, the configuration block goes into one of these files:

Scope	File	When to use it
`user`	`~/.claude.json`	You want `magnews` available in all your projects
`project`	`.mcp.json` in the project root	You want to share it with the team (committed to Git)
`local`	`.claude/settings.local.json` inside the project	Only for you, only in this specific project

In all cases, the configuration block to add under mcpServers is the same:

{
  "mcpServers": {
    "magnews": {
      "transport": "http",
      "url": "https://mcp-mn1.mag-news.it/mcp/stream",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

4. Verify the connection

After the configuration, restart Claude Code and run:

claude mcp list

If the configuration is correct, you will see magnews among the available servers.