skills.rest
peerasak-u
peerasak-uCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

add-mcp-server

Add and configure MCP servers in pi-config with connection verification.

Updated Apr 4, 2026
Search Tags:#automation#validation#configuration#mcp#server#add
One-click install
npx skills add https://github.com/peerasak-u/pi-config --skill add-mcp-server-peerasak-u
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-mcp-server
Source: https://github.com/peerasak-u/pi-config/tree/main/skills/add-mcp-server
Command: npx skills add https://github.com/peerasak-u/pi-config --skill add-mcp-server-peerasak-u

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Add an MCP server configuration to pi-mcp-adapter. Determine scope and server type, write the config, and verify the connection.

Core Features & Use Cases

  • Determine scope (global or project-local) and create corresponding config files.
  • Determine server type (stdio or HTTP) and merge into mcpServers.
  • Verify the connection with a quick test and provide guidance for troubleshooting.

Quick Start

Provide the server name, type (stdio or http), and optional configuration details to create and verify a new MCP server.

Frequently Asked Questions about add-mcp-server

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

FAQPage Schema
How do I add an MCP server configuration to my project?▼

To add an MCP server, provide the server name, connection type (stdio or HTTP), and optional details. The configuration is merged into the mcpServers object within your local .pi/mcp.json file.

What is the difference between global and project-local MCP server configuration?▼

Global MCP server configuration is written to ~/.pi/agent/mcp.json for system-wide access, while project-local configuration uses .pi/mcp.json to restrict server availability to a specific project directory.

Can I configure both stdio and HTTP connections for an MCP server?▼

Yes, you can select between stdio and HTTP connection types when setting up an MCP server. The configuration is determined based on the server type you specify during the setup process.

How do I verify an MCP server connection after writing the config?▼

You can verify an MCP server connection using the built-in quick test workflow. This checks the merged configuration and provides guidance for troubleshooting if the connection fails.

Why is my MCP server not connecting after updating the configuration?▼

If your MCP server is not connecting, the verification workflow provides troubleshooting guidance. Check that the stdio or HTTP settings in your mcpServers object are correctly formatted.

Do I need an existing config file before adding an MCP server?▼

No, you do not need an existing config file. The setup process reads existing config files at ~/.pi/agent/mcp.json or .pi/mcp.json and merges the new server into the mcpServers object.

Related Skills

Explore More Software Engineering Skills→
pulsemcppulsemcp

adjust-claude-mcp-json

Convert flat mcp.json entries into Claude Code's mcpServers structure.

Official
Intermediate
ResgridResgrid
224

ci-cd

Automates .NET CI/CD workflows for GitHub Actions and Azure DevOps via YAML pipelines.

Official
Intermediate
alicanerdoganalicanerdogan
1

add-mcp-server

Add and configure MCP server entries in pi-mcp-adapter configurations.

Community
Intermediate
helix4uhelix4u

mcporter

Manage MCP servers and call their tools via command line.

Community
Intermediate