Skip to main content

DX MCP Server

The DX MCP Server is a Model Context Protocol (MCP) server that empowers AI assistants with deep knowledge of PagoPA's DX ecosystem. It bridges the gap between AI-powered development tools and PagoPA's technical documentation, best practices, and code repositories.

What is the Model Context Protocol?​

The Model Context Protocol (MCP) is an open standard that enables AI assistants to interact with external tools and data sources in a structured way. MCP-compliant clients (like GitHub Copilot, Claude Desktop, or VS Code) can connect to MCP servers to access specialized knowledge and capabilities.

How It Works​

The DX MCP Server provides AI assistants with access to:

  1. PagoPA DX Documentation: Query the complete DX technical documentation using natural language
  2. GitHub Code Search: Search for real-world code examples across PagoPA's GitHub repositories
  3. Smart Prompts: Pre-configured prompts designed for common tasks like Terraform configuration, code review, and infrastructure analysis

Getting Started​

Prerequisites​

You'll need:

  • An MCP-compliant AI assistant (GitHub Copilot, VS Code with Copilot, etc.)
  • A GitHub Personal Access Token (PAT) with appropriate permissions

Configuration​

VS Code / GitHub Copilot​

Install in VS Code

After installing the MCP server in VS Code, you need to configure the GitHub Personal Access Token (PAT) for authentication.

Update your MCP configuration file adding the inputs key to your MCP configuration as follows:

{
  "servers": {
    "dx": {
      "url": "https://api.dx.pagopa.it/mcp",
      "type": "http",
      "headers": {
        "x-gh-pat": "${input:github_mcp_pat}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "github_mcp_pat",
      "description": "GitHub Personal Access Token",
      "password": true
    }
  ]
}

You will be prompted to enter your GitHub PAT when you first use the server.

See VS Code MCP docs for more info.

GitHub Copilot Coding Agent​

Configure in your repository settings under "Copilot" >> "Coding agent". See GitHub Copilot MCP docs for more info.

{
  "mcpServers": {
    "pagopa-dx": {
      "url": "https://api.dx.pagopa.it/mcp",
      "type": "http",
      "tools": ["*"],
      "headers": {
        "x-gh-pat": "$COPILOT_MCP_BOT_GH_PAT"
      }
    }
  }
}

GitHub Copilot CLI​

To use the MCP server with GitHub Copilot CLI, run the cli with copilot and prompt /mcp add to start the configuration of the MCP server

Follow the guided wizard to start using the DX MCP server:

  1. Server Name: pagopa-dx
  2. Server Type: 2 (HTTP)
  3. URL: https://api.dx.pagopa.it/mcp
  4. HTTP Headers: {"x-gh-pat": "<your-gh-PAT>"}
  5. Tools: * (leave as is)

Use Tab to navigate between fields and Ctrl+S to save.

Available Capabilities​

Tools​

  • QueryPagoPADXDocumentation: Query the DX documentation using natural language
  • SearchGitHubCode: Find code examples across PagoPA repositories

Prompts​

The server provides a collection of intelligent prompts for common development tasks. These prompts give guidelines to the agent on PagoPA's conventions and best practices. Explore them in the DX prompts catalog.

Learn More​