Remote MCP Server Setup

Configure Yuno’s MCP server for AI-powered development tools

Overview

Yuno provides both a local and remote MCP server for connecting AI development tools to the Yuno payment API. This guide covers configuration for each supported tool.

Server Options

Option	Description	Best For
Local (npx)	Runs on your machine	Individual developers
Remote (hosted)	Yuno-hosted MCP endpoint	Teams, CI/CD pipelines

Local Server Setup

Installation

npm install -g @yuno-payments/mcp-server

Running the Server

yuno-mcp-server --port 3100

The server starts on http://localhost:3100 and accepts MCP protocol connections.

Environment Configuration

Create a .env file in your project root:

YUNO_PUBLIC_KEY=sandbox_pub_xxx
YUNO_PRIVATE_KEY=sandbox_priv_xxx
YUNO_ACCOUNT_CODE=sandbox_acc_xxx
YUNO_ENVIRONMENT=sandbox
YUNO_MCP_PORT=3100

Never commit .env files containing API credentials to version control. Add .env to your .gitignore.

Tool-Specific Configuration

Claude Code

Add the Yuno MCP server to your Claude Code configuration:

// .claude/settings.json
{
  "mcpServers": {
    "yuno": {
      "command": "npx",
      "args": ["@yuno-payments/mcp-server"],
      "env": {
        "YUNO_PUBLIC_KEY": "sandbox_pub_xxx",
        "YUNO_PRIVATE_KEY": "sandbox_priv_xxx",
        "YUNO_ACCOUNT_CODE": "sandbox_acc_xxx",
        "YUNO_ENVIRONMENT": "sandbox"
      }
    }
  }
}

Cursor

Configure in Cursor settings:

1. Open Cursor Settings

   Navigate to Settings > MCP Servers.

2. Add Yuno MCP

   Click Add Server and enter:

   Field	Value
   Name	Yuno Payments
   Command	npx @yuno-payments/mcp-server
   Transport	stdio

3. Set environment variables

   Add your sandbox credentials in the environment variables section.

Windsurf

Add to your Windsurf MCP configuration:

// .windsurf/mcp.json
{
  "servers": {
    "yuno": {
      "command": "npx",
      "args": ["@yuno-payments/mcp-server"],
      "env": {
        "YUNO_PUBLIC_KEY": "sandbox_pub_xxx",
        "YUNO_PRIVATE_KEY": "sandbox_priv_xxx",
        "YUNO_ACCOUNT_CODE": "sandbox_acc_xxx"
      }
    }
  }
}

VS Code with Continue

// .continue/config.json
{
  "mcpServers": [
    {
      "name": "yuno",
      "command": "npx",
      "args": ["@yuno-payments/mcp-server"],
      "env": {
        "YUNO_PUBLIC_KEY": "sandbox_pub_xxx",
        "YUNO_PRIVATE_KEY": "sandbox_priv_xxx",
        "YUNO_ACCOUNT_CODE": "sandbox_acc_xxx"
      }
    }
  ]
}

Remote Server (Hosted)

For team environments, use Yuno’s hosted MCP endpoint:

MCP Endpoint: https://mcp.y.uno/v1
Authentication: Bearer token (your sandbox private-secret-key)

Configure your AI tool to connect to the remote endpoint instead of running a local server:

{
  "mcpServers": {
    "yuno": {
      "url": "https://mcp.y.uno/v1",
      "headers": {
        "Authorization": "Bearer sandbox_priv_xxx",
      }
    }
  }
}

The remote MCP server connects directly to the Yuno sandbox API. No local server installation is needed. Ensure your network allows outbound HTTPS connections to mcp.y.uno.

Verifying the Connection

After configuration, test the connection:

1. Open your AI tool and start a new conversation
2. Ask: “List available Yuno payment methods for Brazil”
3. The AI should invoke the get_payment_methods MCP tool and return results

If the connection fails, check:

• Credentials are correct and for the sandbox environment
• The MCP server process is running (for local setup)
• Network connectivity to mcp.y.uno (for remote setup)
• Your AI tool supports MCP protocol

Troubleshooting

MCP server fails to start

Check that Node.js 18+ is installed. Run node --version to verify. Reinstall the package with npm install -g @yuno-payments/mcp-server.

Authentication errors

Verify your sandbox credentials are correct. Test them with a direct API call first:

curl -H "public-api-key: YOUR_KEY" -H "private-secret-key: YOUR_SECRET" \
  https://api-sandbox.y.uno/v1/payments?limit=1

AI tool does not see MCP tools

Restart your AI tool after changing MCP configuration. Some tools require a full restart to detect new MCP servers.