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

eClass MCP Server
sdi2200262
A
security
F
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
5
Python
Remote MCP Server
peteknowsai
-
security
F
license
-
quality
A Cloudflare Workers implementation of Model Context Protocol (MCP) server that enables AI tools to be exposed to Claude and other assistants through OAuth authentication.
Last updated -
14
TypeScript
Remote MCP Server
grocco
-
security
F
license
-
quality
A Cloudflare Workers-based implementation of the Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with external tools through OAuth login.
Last updated -
14
TypeScript
Flux
asrvd
A
security
F
license
A
quality
An AI-powered MCP server that enables natural language interaction with AO (Arweave Operating system) for creating, running, and testing code and handlers without manual coding.
Last updated -
14
886,089
3
TypeScript

View all related MCP servers

Clover MCP Server