amp-add-mcp

Add MCP servers to the Amp environment with user or project scope.

Updated Jun 4, 2026
One-click install
npx skills add https://github.com/hemory/amp --skill amp-add-mcp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: amp-add-mcp
Source: https://github.com/hemory/amp/tree/main/.claude/skills/amp-add-mcp
Command: npx skills add https://github.com/hemory/amp --skill amp-add-mcp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill simplifies the process of adding new MCP (Meta-Cognitive Processing) servers to your Amp setup, ensuring they are configured safely and persist across updates.

Core Features & Use Cases

  • Safe MCP Addition: Adds MCP servers with a default 'user' scope, preventing accidental overwrites and ensuring custom servers survive Amp updates.
  • Flexible Scoping: Allows explicit selection of 'user' or 'project' scope for different sharing and persistence needs.
  • Use Case: You need to integrate a custom Notion MCP server to manage your notes. This Skill allows you to add it easily with the recommended user scope, so it's always available and won't be lost if Amp is updated.

Quick Start

Add a local stdio MCP server named 'gmail' using the command 'claude mcp add --scope user gmail -- --transport stdio -- node .scripts/mcp/gmail-mcp.js'.

Frequently Asked Questions about amp-add-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add an MCP server to my Amp environment safely?

To add an MCP server safely, use a default user-scoped configuration to prevent accidental overwrites and ensure custom server integrations persist across Amp updates.

What is the difference between user and project scope when configuring MCP servers?

User scope is the default recommended setting that persists custom MCP server configurations across updates, while project scope restricts the server integration to a specific project for distinct sharing or persistence needs.

Does Amp MCP server integration support both stdio and http transport protocols?

Yes, Amp MCP server integration facilitates the configuration of various transport protocols, supporting both standard stdio and http server types for diverse custom integrations.

What is the best way to ensure my custom MCP server configuration survives an Amp update?

The best way to ensure your MCP server configuration survives an Amp update is to add the server using the recommended user scope, which provides persistent configuration management.

How do I add a local stdio MCP server using the command line in Amp?

You can add a local stdio MCP server by running the command 'claude mcp add --scope user [name] -- --transport stdio -- [path]', specifying the user scope for safe persistent configuration.