@orbitlogistics/mcp-plain

Servidor MCP para la plataforma de atención al cliente Plain. Proporciona herramientas para gestionar hilos, artículos del centro de ayuda y más a través del Model Context Protocol.

Configuración

Con Claude Code

Añade a .claude/settings.json de tu proyecto:

{
  "mcpServers": {
    "plain": {
      "command": "npx",
      "args": ["-y", "@orbitlogistics/mcp-plain@latest"],
      "env": {
        "PLAIN_API_KEY": "${PLAIN_API_KEY}"
      }
    }
  }
}

Después, define PLAIN_API_KEY en el entorno de tu shell (p. ej. .zshrc, .envrc o un gestor de secretos).

Con otros clientes MCP

Ejecuta el servidor directamente:

PLAIN_API_KEY=plainApiKey_xxx npx @orbitlogistics/mcp-plain@latest

Related MCP server: plane-mcp-server

Herramientas

Nota: Este servidor no cubre toda la API de Plain, solo los endpoints que usamos activamente. Si necesitas métodos adicionales, ¡los PR son bienvenidos!

Hilos

• list_threads - Lista hilos con filtros (estado, prioridad, etiquetas, cliente, tenant)

• get_thread - Obtén los detalles completos del hilo por ID (incluye la cronología)

• get_thread_by_ref - Obtén el hilo por número de referencia (p. ej. T-510)

• get_thread_fields - Obtén los valores de los campos personalizados de un hilo

• create_thread - Crea un nuevo hilo (crea automáticamente al cliente a partir del correo electrónico si es necesario)

• reply_to_thread - Envía una respuesta a través del canal original

• mark_thread_as_done - Marca un hilo como resuelto

• upsert_thread_field - Establece/actualiza los valores de los campos personalizados

• add_internal_note - Publica una nota interna (no visible para el cliente)

• add_labels - Añade etiquetas de categoría a un hilo

• get_label_types - Lista los tipos de etiquetas disponibles

Enlaces de hilos

• link_threads - Enlaza un hilo con otro hilo de Plain, un issue de Linear, un issue de Jira o una fuente genérica

• get_thread_links - Lista los enlaces de un hilo

• unlink_thread - Elimina un enlace por su ID de enlace

get_thread y get_thread_by_ref también devuelven los primeros 25 enlaces de un hilo en un array links.

Adjuntos

• get_attachment_download_url - Obtén una URL de descarga temporal

• get_attachment_content - Recupera el contenido del adjunto (texto o base64)

Centro de ayuda

• list_help_centers - Lista todos los centros de ayuda

• get_help_center - Obtén la estructura del centro de ayuda (grupos y artículos)

• list_help_center_articles - Lista artículos con el contenido completo

• get_help_center_article - Obtén el artículo por ID

• get_help_center_article_by_slug - Obtén el artículo por slug de URL

• upsert_help_center_article - Crea o actualiza un artículo (siempre se guarda como DRAFT)

• create_help_center_article_group - Crea un grupo de artículos

• delete_help_center_article_group - Elimina un grupo de artículos vacío

Desarrollo

pnpm install
pnpm test
pnpm build

Licencia

MIT