Sparkier

Conecta Sparkier a tu asistente de IA

El servidor MCP de Sparkier permite que un modelo de lenguaje grande (LLM) interactúe con tu cuenta de Sparkier: listar y gestionar tus Sparks, consultar y modificar tu perfil de consultor (borrador y publicación), gestionar tus publicaciones sociales (LinkedIn), gestionar tus artículos vinculados a un Spark y consultar tus entregables de consultoría (actas de sesión). La autenticación se realiza mediante OAuth: autorizas al asistente una sola vez y luego puede llamar a las herramientas con tus permisos.

Elige tu asistente para ver las instrucciones detalladas:

ChatGPT

Para usar todas las herramientas de Sparkier (y no solo search/fetch), debes activar el Developer Mode.

URL a utilizar

https://www.sparkier.io/api/mcp

Pasos

1. Ve a la sección Applications de ChatGPT.
2. Arriba a la derecha, haz clic en el icono Settings.
3. Haz clic en Advanced settings.
4. Activa el modo desarrollador.
5. Haz clic en Create app arriba.
6. Introduce la URL del servidor MCP indicada arriba. Elige OAuth si se ofrece (Sparkier usa OAuth).

En el primer uso, autoriza el acceso a Sparkier. Luego puedes pedirle a ChatGPT que use las herramientas (por ejemplo, «Lista mis Sparks», «Crea un Spark con el título X», «Actualiza el borrador de mi artículo vinculado al Spark Y» o «Lista mis actas de consultoría»).

---

Mistral

URL a utilizar

https://www.sparkier.io/api/mcp

Pasos

1. Abre la interfaz de Mistral (Le Chat o la de tu suscripción).
2. Ve a Settings (o Parámetros) → Connectors / Custom connectors.
3. Haz clic en Add custom connector (o equivalente).
4. Pega la URL indicada arriba.
5. Guarda y luego conéctate a Sparkier cuando se te pida y valida la autorización.

Después de la conexión, las herramientas de Sparkier (Sparks, perfil de consultor, publicaciones sociales, artículos y entregables de consultoría) están disponibles para el asistente.

---

Claude

URL a utilizar

https://www.sparkier.io/api/mcp

Pasos

Para Claude, el uso del MCP solo es posible en la aplicación.

1. Abre la aplicación Claude.
2. Ve a Settings -> Developer.
3. Haz clic en Edit Config.
4. Esto abre un archivo. Ábrelo en tu editor de texto favorito y reemplaza el contenido con el siguiente texto.

{
  "mcpServers": {
    "sparkier": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://www.sparkier.io/api/mcp"
      ]
    }
  },
  "preferences": {
    "coworkScheduledTasksEnabled": false,
    "sidebarMode": "chat",
    "coworkWebSearchEnabled": true
  }
}

---

Solución de problemas

• Nada se conecta: verifica que la URL utilizada sea https://www.sparkier.io/api/mcp.
• Error 401 / autenticación: vuelve a hacer la autorización OAuth (desconecta el conector y vuelve a conectarte).
• Bucle de reconexión: elimina el conector en los parámetros del asistente y luego agrégalo de nuevo con la misma URL.

---

Recursos y herramientas MCP disponibles

Resumen

Dominio	Objeto	Prefijo de las herramientas
Sparks	Ofertas de consultoría (título, descripción, duración, precio)	my_sparks_list, sparks_get, spark_*
Perfil	Página de presentación del consultor (bio, competencias, reseñas)	my_profile_get, profile_*
Publicaciones	Publicaciones de LinkedIn (borradores, programación)	my_posts_list, post_get, post_*
Artículos	Artículos de blog vinculados a un Spark	my_articles_list, article_get, article_*
Entregables	Actas de consultoría (secciones markdown)	my_deliverables_list, deliverable_get

Recurso (lectura sin herramienta)

Recurso	URI	Descripción
Mis Sparks (resumen)	sparkier://my/sparks-summary	Lista de los Sparks del usuario conectado. Devuelve hasta 50 Sparks, ordenados por fecha. El asistente puede descubrir y leer este recurso sin llamar a una herramienta.

Sparks (ofertas de consultoría)

Herramienta	Descripción
my_sparks_list	Lista los Sparks. Filtros: publicationStatus, sort, limit, offset.
sparks_get	Recupera un Spark por id o slug.
spark_create	Crea un Spark (borrador o publicado si publish: true).
spark_update	Actualiza un Spark. Para un Spark publicado, crea una revisión; llama a spark_publish para hacer visibles los cambios.
spark_publish	Publica un borrador. Requiere un perfil de consultor completo.

Perfil de consultor (página de presentación)

Herramienta	Descripción
my_profile_get	Recupera el perfil (fusionado con el borrador). Devuelve hasUnpublishedDraft si hay modificaciones no publicadas.
profile_draft_update	Actualiza el borrador (nombre, bio, idiomas, competencias, enlaces sociales, reseñas, misiones).
profile_publish	Publica el borrador en la página de presentación.
profile_draft_discard	Cancela el borrador sin publicar.

Publicaciones sociales (LinkedIn)

Herramienta	Descripción
my_posts_list	Lista las publicaciones. Filtros: platform, status, limit, orderBy, orderDirection.
post_get	Recupera una publicación por postId.
post_draft_create	Crea un borrador de publicación.
post_draft_update	Actualiza un borrador (content, url).
post_schedule	Programa la publicación. Sin fecha scheduledFor, Sparkier elige el mejor horario. Requiere una conexión de LinkedIn establecida en Sparkier.
post_publish	Publica inmediatamente en LinkedIn. Requiere una conexión de LinkedIn establecida en Sparkier.
post_draft_discard	Elimina definitivamente un borrador de publicación.

Artículos (vinculados a los Sparks)

Herramienta	Descripción
my_articles_list	Lista los artículos. Filtros: sparkId, status, includeArchived, limit.
article_get	Recupera un artículo por articleId.
article_draft_create	Crea un artículo vinculado a un Spark.
article_draft_update	Actualiza un borrador de artículo.
article_publish	Publica un artículo.
article_unpublish	Despublica (vuelve al borrador).
article_archive	Archiva (oculto de las listas).

Entregables (actas de consultoría)

Solo lectura. Los entregables son actas generadas después de una sesión (secciones markdown: contexto, participantes, síntesis, próximos pasos, etc.).

Herramienta	Descripción
my_deliverables_list	Lista todos los entregables accesibles (misiones donde eres consultor o cliente). Cada entrada incluye perspective: consultant (producidos, todos los estados) o client (recibidos, solo dispatched). Las cuentas con ambos roles obtienen una lista combinada. No se requieren parámetros.
deliverable_get	Recupera un entregable por deliverableId (UUID) con el título, el resumen, el estado, las secciones markdown completas, el Spark asociado, la fecha de la sesión y un enlace a la página de Sparkier. Los consultores y administradores leen el borrador si existe; los clientes solo leen la versión enviada.

Ejemplos de solicitudes al asistente:

• Consultor: «Lista mis actas de consultoría» → my_deliverables_list
• Consultor: «Muéstrame el acta de mi última sesión con Marie» → my_deliverables_list y luego deliverable_get
• Cliente: «¿Qué actas he recibido?» → my_deliverables_list
• Cliente: «Resúmeme el acta de mi consultoría del 15 de marzo» → deliverable_get

Códigos de error

Las herramientas pueden devolver los siguientes códigos de error en el campo code de la respuesta:

Código	Cuándo ocurre
validation_error	Parámetros inválidos (formato incorrecto, campos obligatorios faltantes, valores fuera de rango). Corrige la entrada y vuelve a intentarlo.
role_required	El usuario no tiene el rol requerido para la acción (consultor o administrador para Sparks, perfil, publicaciones y artículos; consultor o cliente para los entregables).
profile_incomplete	Perfil de consultor incompleto al intentar publicar un Spark. Pide al usuario la información faltante, usa profile_draft_update y luego profile_publish, y vuelve a intentar spark_publish.
duplicate_title	El título del Spark coincide con otro. Cambia el título y vuelve a intentar spark_publish.
duplicate_content	El contenido del Spark es demasiado similar a otro. Personaliza el título o el contenido y vuelve a intentar spark_publish.
not_found	Recurso no encontrado o no autorizado (Spark, publicación, artículo, etc.). Verifica el ID con la herramienta de lista correspondiente (my_sparks_list, my_posts_list, my_articles_list, my_deliverables_list) y vuelve a intentarlo.
deliverable_not_found	Entregable no encontrado. Usa my_deliverables_list para obtener un deliverableId válido y vuelve a intentar deliverable_get.
not_dispatched	Entregable aún no enviado al cliente. Pide al consultor que lo envíe y vuelve a intentar deliverable_get.
forbidden	Acceso denegado a este entregable. Usa my_deliverables_list para ver los entregables accesibles.
not_published	Artículo no publicado durante un article_unpublish. Pide al usuario que confirme el artículo o usa article_publish primero.