Servidor MCP de Pagaments

Primer servidor MCP de pagaments de Turquia

El servidor MCP de pagaments Wagmi Tech és un servidor Model Context Protocol (MCP) que ofereix una integració sense fail amb proveïdors de serveis de pagaments, permetent als desenvolupadors i agents d'IA crear i gestionar enllaços de pagament amb facilitat.

Casos d'ús

Transforma com funcionen els pagaments amb el nostre Servidor MCP de pagaments:

• Servei al client amb IA: Permet als assistents d'IA crear enllaços de pagament durant les interaccions amb els clients
• Facturació automatitzada: Genera sol·licituds de pagament a través d'IA conversacional
• Innovació en e-commerce: Integra la creació d'enllaços de pagament en processos de venda impulsats per IA
• Automatització empresarial: Simplifica els fluxos de treball d'emissions de factures i recollida de pagaments
• Gestió de concessions: Permet a concessions i negocis minoristes recollir pagaments, dipòsits i instal·lacions a través de sistemes impulsats per IA

Proveïdors suportats

• Moka United - Un dels principals proveïdors de serveis de pagaments de Turquia ✅
• Més proveïdors aviat... 🔄

Com primer servidor MCP de pagaments de Turquia, ens comprometem a ampliar el suport a tots els principals proveïdors de serveis de pagaments.

Eines disponibles

create_payment_link

Crea una sol·licitud de pagament

Paràmetres obligatoris:

• amount (float): Import del pagament

Paràmetres opcionals:

• other_trx_code (string): Codi de transacció per a la conciliació
• full_name (string): Nom complet del client
• email (string): Correu electrònic del client
• currency (string): Moneda del pagament (per defecte: "TL")
• installment_number (int): Nombre d'instal·lacions
• i molts més...

Ús amb el client MCP (p. ex., Claude Desktop, Cursor)

1. Construir la imatge Docker

docker build -t payment-mcp-server .

2. Configurar el client MCP

Afegiu la configuració del servidor al vostre client MCP (p. ex., Claude Desktop, Cursor):

{
  "mcpServers": {
    "payment-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "PROVIDER",
        "-e", "DEALER_CODE",
        "-e", "USERNAME",
        "-e", "PASSWORD",
        "-e", "CUSTOMER_TYPE_ID",
        "payment-mcp-server"
      ],
      "env": {
        "PROVIDER": "moka",
        "DEALER_CODE": "your_dealer_code",
        "USERNAME": "your_username",
        "PASSWORD": "your_password",
        "CUSTOMER_TYPE_ID": "your_customer_type_id"
      }
    }
  }
}

3. Provar el servidor (opcional)

# Test with environment variables
docker run -it \
  -e PROVIDER="moka" \
  -e DEALER_CODE="your_dealer_code" \
  -e USERNAME="your_username" \
  -e PASSWORD="your_password" \
  -e CUSTOMER_TYPE_ID="your_type_id" \
  payment-mcp-server

4. Preparat per usar en el client MCP

Un cop configurat, podeu utilitzar l'eina create_payment_link al vostre client MCP per crear sol·licituds de pagament.

Arquitectura

Aquest servidor segueix els principis d'arquitectura neta amb una clara separació de responsabilitats:

• core/ - Lògica de negoci i interfícies principals
• providers/ - Implementacions de proveïdors de pagaments (Moka United, ampliable a altres)
• utils/ - Funcions d'utilitat (registres, autenticació, validació)
• errors/ - Classes de gestió d'errors personalitzats
• config/ - Gestió de configuració

Mode de transport

Aquest servidor utilitza transport stdio per a connexions directes amb el client MCP a través de comunicació stdin/stdout.

Ús de Docker

Construir la imatge

docker build -t payment-mcp-server .

Executar el servidor

# Run with environment variables
docker run -it \
  -e PROVIDER="moka" \
  -e DEALER_CODE="your_dealer_code" \
  -e USERNAME="your_username" \
  -e PASSWORD="your_password" \
  -e CUSTOMER_TYPE_ID="your_customer_id" \
  payment-mcp-server

# Or with .env file
docker run -it --env-file .env payment-mcp-server

# Run with different provider (currently only moka is supported)
docker run -it \
  -e PROVIDER="moka" \
  -e DEALER_CODE="your_dealer_code" \
  -e USERNAME="your_username" \
  -e PASSWORD="your_password" \
  payment-mcp-server

# The server communicates via stdin/stdout for direct MCP client connection

Ús de Docker Compose

# Create .env file with your credentials first
echo "PROVIDER=moka" > .env
echo "DEALER_CODE=your_dealer_code" >> .env
echo "USERNAME=your_username" >> .env  
echo "PASSWORD=your_password" >> .env
echo "CUSTOMER_TYPE_ID=your_type_id" >> .env

# Run the server
docker-compose up

Variables d'entorn

Opcions CLI

Registres

Els registres es guarden a /app/logs/ dins del contenidor. Per a persistir els registres, muntar un volum:

docker run -v ./logs:/app/logs payment-mcp-server

Suport i ajuda

Necessiteu ajuda per configurar o utilitzar el servidor MCP de pagaments Wagmi Tech?

Contacteu amb nosaltres:hello@wagmitech.co

Estem aquí per ajudar-vos a integrar capacitats de pagament en els vostres fluxos de treball d'IA.

Aquest servidor MCP de pagaments és només el principi de la nostra visió per fer el processament de pagaments més intel·ligent, accessible i integrat en l'ecosistema d'IA.

Wagmi Tech

Tots ho farem!