Esa.io

Accede a la API de esa.io para gestionar la base de conocimiento de tu equipo.

GitHub
1
Prueba este MCPPatrocinado

Documentación

mcp-esa-server-python

Model Context Protocol Server (mcp server) para integrarse con la API de esa.io. Está implementado en Python.

Funcionalidades

Actualmente se ofrecen las siguientes funciones:

  • Obtener información del usuario (user_get_info)
  • Obtener lista de artículos (posts_get_list)
  • Obtener detalle de un artículo (posts_get_detail)
  • Crear artículo (posts_create)
  • Actualizar artículo (posts_update)
  • Eliminar artículo (posts_delete)

Pasos de configuración

Requisitos previos

  • Tener un token de API de esa.io emitido

  • Poder usar uv

  • Conexión a internet

  • Cómo emitir un token de API de esa.io

    • Accede a la página de tu equipo de esa.io (ejemplo: https://<your-team-name>.esa.io/).
    • Haz clic en SETTINGS en la columna izquierda y selecciona «Configuración de usuario» > «Integración de aplicaciones externas».
    • En la sección «Personal access tokens», haz clic en «Generate new token».
    • Introduce un nombre para el token (ejemplo: mcp-server) y selecciona los ámbitos de permisos necesarios. Este servidor MCP requiere al menos los siguientes permisos:
      • read (lectura de artículos)
      • write (crear, actualizar y eliminar artículos)
      • read_user (obtener información del usuario) (este elemento se activa automáticamente, por lo que es posible que no se muestre)
    • Haz clic en «Save».
    • Asegúrate de copiar el token mostrado y guardarlo en un lugar seguro. Este token solo se muestra una vez.
    • Pega el token copiado como valor de ESA_TOKEN en el archivo .env que se describe más adelante.

  • En esa.io se ofrece un período de prueba gratuito de 2 meses desde el registro. Puedes aprovechar este período para obtener un nombre de equipo y un token de API de prueba.

  • Por seguridad, ten cuidado de no publicar el token directamente.

Inicialización del proyecto

uv sync

Desarrollo (uso local)

Si participas en el desarrollo o utilizas MCPInspector, configura el entorno siguiendo los pasos a continuación.

  1. Configuración de variables de entorno Consulta .env.example como referencia y crea .env en el directorio donde deseas ejecutar el servidor (en el mismo lugar que .env.example).

    ESA_TEAM_NAME="YOUR_ESA_TEAM_NAME" # Replace with your esa.io team name (e.g., "myteam")
ESA_TOKEN="YOUR_ESA_API_TOKEN"     # Replace with your esa.io API access token

  2. Método de ejecución Después de ejecutar el siguiente comando, abre el navegador desde la URL indicada para poder ejecutar cada comando (como crear artículos) usando MCP Inspector.

    uv run mcp run main.py

Cómo usar como servidor MCP en el editor Cursor

  1. Ejemplo de creación de mcp.json

Prepara un archivo de configuración como el siguiente en la raíz del proyecto o en ~/.cursor/mcp.json.

{
  "mcpServers": {
    "mcp-esa-server": {
      "command": "uv",
      "args": [
        "--directory",
        "<プロジェクトの絶対パス>",
        "run",
        "main.py"
      ],
      "env": {
        "ESA_TEAM_NAME": "<your-team-name>",
        "ESA_TOKEN": "<your-esa-token>"
      }
    }
  }
}
  • Reemplaza <your-team-name> y <your-esa-token> con el nombre de tu equipo de esa.io y tu token de API.
  • env: configura las variables de entorno directamente. Si usas este método, evita absolutamente hacer commit de .cursor/mcp.json.
  1. Iniciar el servidor MCP en el editor Cursor
  • Desde la paleta de comandos o la interfaz de usuario del editor Cursor, selecciona «Iniciar servidor MCP» o «Habilitar herramientas de IA».
  • Según la configuración de mcp.json, el servidor se iniciará con uv run main.py.
  • El archivo .env y las variables de entorno también se cargan automáticamente.
  1. Llamar a la API desde el chat de IA o el panel de herramientas
  • Al llamar a herramientas MCP como user_get_info o posts_get_list en el chat de IA, es posible realizar operaciones integradas con la API de esa.io.
  • Se puede usar escribiendo en el chat algo como mcp-esa-serverを使って記事の作成をお願いします.

Licencia

Este proyecto se publica bajo la Licencia MIT.

Código externo utilizado / Dependencias

Parte de este proyecto hace referencia a código publicado bajo la Licencia MIT que se indica a continuación.

Otros (Misc)

Generado por

generated by Cursor (gemini-2.5-pro-exp-03-25)