Servidor Clover MCP

Servidor Clover MCP (Protocolo de contexto de modelo)

Un servidor MCP mínimo para interactuar con la API de Clover mediante la autenticación OAuth.

Descripción general

Este servidor MCP permite que los modelos de IA generativa y otros clientes accedan a los datos de sus comerciantes de Clover mediante el Protocolo de Contexto de Modelo. Con esta integración, los modelos pueden:

Recuperar información del comerciante
Lista de artículos del inventario
Órdenes de lista
Acceder a artículos y pedidos individuales

Inicio rápido

Instalación mediante herrería

Para instalar Clover MCP Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @ibraheem4/clover-mcp --client claude

Uso con Claude AI (recomendado)

Agregue esto a su configuración de Claude MCP (generalmente en ~/.config/anthropic/claude.mcp.json ):

{
  "mcpServers": {
    "clover": {
      "command": "npx",
      "args": ["-y", "@ibraheem4/clover-mcp"],
      "env": {
        "CLOVER_CLIENT_ID": "your-clover-client-id",
        "CLOVER_CLIENT_SECRET": "your-clover-client-secret",
        "CLOVER_BASE_URL": "https://apisandbox.dev.clover.com"
      },
      "disabled": false,
      "autoApprove": ["initiate_oauth_flow", "get_merchant_info", "list_inventory", "list_orders"]
    }
  }
}

Úselo con Claude:

/mcp use clover

Inicie el flujo OAuth en su conversación con Claude:

Can you help me connect to my Clover account?

Uso a través de la línea de comandos

Puede ejecutar el servidor MCP directamente:

# Install and run in one command
npx @ibraheem4/clover-mcp

# With credentials
CLOVER_CLIENT_ID=your-client-id CLOVER_CLIENT_SECRET=your-client-secret npx @ibraheem4/clover-mcp

Configuración de OAuth de Clover

Antes de utilizar este servidor MCP, debe configurar una aplicación Clover:

Cree una cuenta de desarrollador de Clover en developer.clover.com
Registrar una nueva aplicación en el Panel de desarrolladores de Clover
Configura tu aplicación con:
- URL del sitio: http://localhost:4000/oauth-callback
- Respuesta OAuth predeterminada: Code
Anote su ID de cliente y su secreto de cliente
Agregue estas credenciales a su entorno o archivo .env

Herramientas MCP

Las siguientes herramientas están disponibles a través del protocolo MCP:

get_oauth_status : Comprueba si las credenciales de OAuth están disponibles
initiate_oauth_flow : Inicia el flujo OAuth para obtener tokens de acceso
get_merchant_info : Obtener información sobre el comerciante
list_inventory : Lista de artículos de inventario con filtros opcionales
list_orders : Lista de pedidos con filtros opcionales

Ejemplo de uso con Claude

A continuación se muestran algunos ejemplos de indicaciones que puedes utilizar con Claude después de conectarte:

Conectarse a Clover :
I'd like to connect to my Clover account.
Obtener información del comerciante :
What information do you have about my Clover merchant account?
Lista de artículos del inventario :
Show me the first 10 items in my inventory.
Órdenes de lista :
Can you list my most recent orders?

Desarrollo

Instalación local

Clonar este repositorio
Instalar dependencias:
npm install
Configure sus credenciales de OAuth:
cp .env.example .env # Edit .env with your Clover OAuth credentials
Construya el código TypeScript:
npm run build
Inicie el servidor MCP:
./run.sh

Actualizaciones de publicación

Para publicar una nueva versión en npm:

# Update version in package.json
npm version patch  # or minor, or major

# Build and publish
npm run build
npm publish

Solución de problemas

Si encuentra problemas con OAuth:

Verifique que su aplicación Clover esté registrada correctamente
Comprueba que la URL del sitio en la configuración de tu aplicación esté configurada en http://localhost:4000/oauth-callback
Asegúrese de que su ID de cliente y su secreto de cliente sean correctos
Asegúrese de que la "Respuesta OAuth predeterminada" esté configurada en "Código" en el panel del desarrollador.
Intente iniciar el flujo OAuth nuevamente con initiate_oauth_flow

Licencia

Instituto Tecnológico de Massachusetts (MIT)

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Permite que los agentes de IA accedan e interactúen con los datos de comerciantes, el inventario y los pedidos de Clover a través de un servidor MCP autenticado mediante OAuth seguro.

Related Resources

Reddit Discussion about this server

Related MCP Servers

ClickUp MCP Server
Nazruden
A
security
A
license
A
quality
This server integrates AI assistants with ClickUp workspaces, enabling task, team, list, and board management through a secure OAuth2 authentication process.
Last updated -
5
56
7
TypeScript
MIT License
Fewsats MCP Serverofficial
Fewsats
A
security
F
license
A
quality
An MCP server that integrates with Fewsats allowing AI agents to securely purchase anything by retrieving balances, accessing payment methods, and processing payments.
Last updated -
4
13
Python
Armor Crypto MCPofficial
armorwallet
A
security
A
license
A
quality
An MCP server providing unified access to blockchain operations, bridging, swapping, and crypto trading strategies for AI agents.
Last updated -
20
141
Python
GPL 3.0
eClass MCP Server
sdi2200262
A
security
A
license
A
quality
An MCP server that enables AI agents to authenticate with and interact with Open eClass platform instances, supporting UoA's SSO authentication system for retrieving course information and performing basic platform operations.
Last updated -
4
1
Python
MIT License

View all related MCP servers

Clover MCP Server