🚀 Servidor MCP Uberall

Un Model Context Protocol (MCP) servidor que s'integra amb l'Uberall API, permetent als assistents IA gestionar sense problemes les llistes d’empreses, les ubicacions i la presència a les xarxes socials a través de múltiples plataformes.

🎯 Què és MCP?

El Model Context Protocol permet als assistents IA com Claude, Cursor o VS Code Copilot connectar-se a eines externes i fonts de dades. Aquest servidor actua com a pont entre els assistents IA i la potent plataforma Uberall.

Això permet una integració sense costures amb LLMs com Claude, Cursor o Language Model APIs per a fluxos de treball de gestió empresarial complet.

🚀 Inici ràpid

📦 Opció 1: Descarregar JAR preconstruït

# Descarregar l'última versió
curl -L -o uberall-mcp-server.jar https://github.com/uberall/uberall-mcp-server/releases/latest/download/uberall-mcp-server.jar

# Configurar credencials
export UBERALL_URL="https://sandbox.uberall.com"
export UBERALL_ACCESS_TOKEN="your_access_token_here"

# Executar el servidor
java -jar uberall-mcp-server.jar

🐳 Opció 2: Usar Docker

export UBERALL_URL="https://sandbox.uberall.com"
export UBERALL_ACCESS_TOKEN="your_access_token_here"
docker run --rm -i -e UBERALL_ACCESS_TOKEN -e UBERALL_URL uberall/uberall-mcp-server:latest

🛠️ Opció 3: Construir des de codi font

git clone https://github.com/uberall/uberall-mcp-server.git
cd uberall-mcp-server
./gradlew shadowJar

export UBERALL_URL="https://sandbox.uberall.com"
export UBERALL_ACCESS_TOKEN="your_access_token_here"
java -jar build/libs/uberall-mcp-server.jar

�️ Configuració detallada

Requisits

• Java 17 o superior (verificar amb java -version)
• Docker (alternativa a la instal·lació de Java)
• Gradle (només si es construeix des del codi font)

⚠️ Important: Aquest servidor requereix Java 17+. Si obté UnsupportedClassVersionError, està utilitzant una versió de Java més antiga. Use java -version per comprovar la seva versió.

Variables d'entorn necessàries

Abans d'executar el servidor, ha de configurar aquestes variables d'entorn:

• UBERALL_URL(obligatori): L'URL base de l'API Uberall
  • Producció: https://uberall.com
  • Sandbox: https://sandbox.uberall.com
• UBERALL_ACCESS_TOKEN(obligatori): El token d'accés a l'API Uberall

Obtenir el token d'accés a l'API Uberall:

Seguiu la documentació oficial d'Uberall: 📖 API Authentication Guide

📦 Opcions d'instal·lació

Descarregueu l'últim JAR des de GitHub Releases:

curl -L -o uberall-mcp-server.jar https://github.com/uberall/uberall-mcp-server/releases/latest/download/uberall-mcp-server.jar

Descàrrega manual:

1. Visiteu GitHub Releases
2. Descarregueu uberall-mcp-server.jar de l'última versió

Després executeu:

# Configurar variables d'entorn
export UBERALL_URL="https://sandbox.uberall.com"
export UBERALL_ACCESS_TOKEN="your_access_token_here"
java -jar uberall-mcp-server.jar

🧠 Configurar amb eines IA

Claude Desktop

Afegiu a claude_desktop_config.json:

{
  "mcpServers": {
    "uberall-mcp-server": {
      "command": ["java", "-jar", "/path/to/uberall-mcp-server.jar"],
      "env": {
        "UBERALL_ACCESS_TOKEN": "your_access_token_here",
        "UBERALL_URL": "https://sandbox.uberall.com"
      }
    }
  }
}

Altres clients MCP (Cursor, VS Code, etc.)

Per a altres eines compatibles amb MCP, podeu utilitzar aquest enfocament general:

1. Crea un fitxer mcp.json al teu projecte:

touch mcp.json

2. Afegiu la següent configuració al fitxer:

{
  "mcpServers": {
    "uberall-mcp-server": {
      "command": "java",
      "args": ["-jar", "/path/to/uberall-mcp-server.jar"],
      "type": "stdio",
      "env": {
        "UBERALL_ACCESS_TOKEN": "your_access_token_here",
        "UBERALL_URL": "https://sandbox.uberall.com"
      }
    }
  }
}

3. Desa el fitxer i reinicia la teva IDE/eina. Ara hauríeu de poder accedir a totes les eines!

Altres clients MCP: La llista de clients populars està disponible aquí.

💡 Consell: Substitueix /path/to/uberall-mcp-server.jar pel camí real on has descarregat el fitxer JAR.

🐳 Suport Docker

Usar la imatge Docker preconstruïda (Recomanat)

export UBERALL_ACCESS_TOKEN="your_access_token_here"
export UBERALL_URL="https://sandbox.uberall.com"
docker run --rm -i -e UBERALL_ACCESS_TOKEN -e UBERALL_URL uberall/uberall-mcp-server:latest

🧠 Utilitzar amb Claude Desktop

Configura a claude_desktop_config.json:

{
  "mcpServers": {
    "uberall-mcp-server": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "UBERALL_ACCESS_TOKEN=$UBERALL_ACCESS_TOKEN", "-e", "UBERALL_URL=$UBERALL_URL", "uberall/uberall-mcp-server:latest"],
      "type": "stdio"
    }
  }
}

git clone https://github.com/uberall/uberall-mcp-server.git
cd uberall-mcp-server
cp src/test/resources/test-config-example.properties src/test/resources/test-config.properties
# Edita test-config.properties amb les teves credencials de prova
./gradlew test