skills.rest
sergical
sergicalCOMMUNITY
Explore all skills by this author →
Website𝕏@sergicalGitHub

add-mcp-server

Configure stdio or HTTP MCP servers for global and project-local pi agent settings.

1|Updated Feb 22, 2026
Search Tags:#integration#mcp#http#server configuration#stdio#pi agent
One-click install
npx skills add https://github.com/sergical/pi-config --skill add-mcp-server-sergical
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-mcp-server
Source: https://github.com/sergical/pi-config/tree/main/skills/add-mcp-server
Command: npx skills add https://github.com/sergical/pi-config --skill add-mcp-server-sergical

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies the process of adding and configuring Message Communication Protocol (MCP) servers, whether for global use or specific projects, ensuring seamless integration with pi-mcp-adapter.

Core Features & Use Cases

  • Flexible Configuration: Supports both global (~/.pi/agent/mcp.json) and project-local (.pi/mcp.json) configurations, with local settings overriding global ones.
  • Multiple Server Types: Handles both stdio (local command execution) and HTTP (remote URL) server connections.
  • Detailed Configuration Options: Allows for specifying commands, arguments, environment variables, URLs, headers, authentication methods, and lifecycle management.
  • Use Case: You need to connect your pi agent to a new internal development server for code completion. This Skill will guide you through setting up the server's connection details, including its URL and any necessary authentication headers, and then verify the connection.

Quick Start

Use the add-mcp-server skill to add a new http mcp server named 'dev-server' to your global configuration.

Frequently Asked Questions about add-mcp-server

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

FAQPage Schema
How do I configure an MCP server for the pi agent?▼

To configure an MCP server for the pi agent, you set up connection details in either a global (~/.pi/agent/mcp.json) or project-local (.pi/mcp.json) configuration file. This allows you to define server types, authentication, and lifecycle policies for seamless agent communication.

What is the difference between stdio and HTTP MCP server connections?▼

Stdio MCP server connections execute local commands, while HTTP MCP servers connect to remote URLs. The configuration process for both involves specifying commands and arguments for stdio, or URLs and headers for HTTP, to establish proper agent integration.

Can I set different MCP server configurations for specific projects?▼

Yes, you can set project-local MCP server configurations using a .pi/mcp.json file. These local settings will override the global configurations defined in ~/.pi/agent/mcp.json, allowing project-specific server integration and connection details.

How do I add authentication headers for an HTTP MCP server?▼

You add authentication headers for an HTTP MCP server by specifying them within your pi agent configuration file. This Skill guides you through defining the necessary HTTP headers and authentication methods required to connect to remote server URLs securely.

Does pi agent MCP integration support environment variables for local servers?▼

Yes, pi agent MCP integration supports environment variables when configuring stdio servers. You can specify necessary environment variables alongside local commands and arguments to properly manage the execution and lifecycle of your local MCP server connections.

Related Skills

Explore More Software Engineering Skills→
shaprisshapris

configuring-dbt-mcp-server

Generate dbt MCP server configuration JSON and validate connectivity.

Community
Advanced
peerasak-upeerasak-u

add-mcp-server

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

Community
Intermediate
alicanerdoganalicanerdogan
1

add-mcp-server

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

Community
Intermediate
Luohao-YanLuohao-Yan
6

agent-add-mcp

Add MCP servers to Warp configurations and update .mcp.json files.

Community
Intermediate