Sparkier

Para consultores independentes, estruturação e publicação de ofertas de consultoria

Ver em sparkier.ioExperimente este MCPPatrocinado

Documentação

Conectando o Sparkier ao seu assistente de IA

O servidor MCP Sparkier permite que um grande modelo de linguagem (LLM) interaja com sua conta Sparkier: listar e gerenciar seus Sparks, consultar e modificar seu perfil de consultor (rascunho e publicação), gerenciar seus posts sociais (LinkedIn), gerenciar seus artigos vinculados a um Spark e consultar seus entregáveis de consultoria (atas de sessão). A autenticação é feita via OAuth: você autoriza o assistente uma vez, e ele pode chamar as ferramentas com seus direitos.

Escolha seu assistente para ver as instruções detalhadas:

ChatGPT

Para usar todas as ferramentas do Sparkier (e não apenas search/fetch), é necessário ativar o Developer Mode.

URL a ser usada

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

Etapas

Vá para a seção Applications do ChatGPT.
No canto superior direito, clique no ícone Configurações.
Clique em Configurações avançadas.
Ative o modo desenvolvedor.
Clique em Criar um app no topo.
Insira a URL do servidor MCP acima. Escolha OAuth se for oferecido (o Sparkier usa OAuth).

No primeiro uso, autorize o acesso ao Sparkier. Depois, você pode pedir ao ChatGPT para usar as ferramentas (por exemplo, "Liste meus Sparks", "Crie um Spark com o título X", "Atualize o rascunho do meu artigo vinculado ao Spark Y" ou "Liste minhas atas de consultoria").

Mistral

URL a ser usada

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

Etapas

Abra a interface do Mistral (Le Chat ou a do seu plano).
Vá em Settings (ou Configurações) → Connectors / Custom connectors.
Clique em Add custom connector (ou equivalente).
Cole a URL acima.
Salve e, em seguida, conecte-se ao Sparkier quando solicitado e valide a autorização.

Após a conexão, as ferramentas do Sparkier (Sparks, perfil de consultor, posts sociais, artigos e entregáveis de consultoria) ficam disponíveis para o assistente.

Claude

URL a ser usada

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

Etapas

Para o Claude, o uso do MCP só é possível no aplicativo.

Abra o aplicativo Claude.
Vá em Configurações -> Desenvolvedor.
Clique em Edit Config.
Isso abrirá um arquivo. Abra-o no seu editor de texto favorito e substitua o conteúdo pelo texto a seguir.

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

Solução de problemas

Nada conecta: verifique se a URL usada é realmente https://www.sparkier.io/api/mcp.
Erro 401 / autenticação: refaça a autorização OAuth (desconecte o conector e conecte-se novamente).
Loop de reconexão: remova o conector nas configurações do assistente e adicione-o novamente com a mesma URL.

Recursos e ferramentas MCP disponíveis

Visão geral

Domínio	Objeto	Prefixo das ferramentas
Sparks	Ofertas de consultoria (título, descrição, duração, preço)	`my_sparks_list`, `sparks_get`, `spark_*`
Perfil	Página de vitrine do consultor (bio, competências, avaliações)	`my_profile_get`, `profile_*`
Posts	Publicações no LinkedIn (rascunhos, agendamento)	`my_posts_list`, `post_get`, `post_*`
Artigos	Artigos de blog vinculados a um Spark	`my_articles_list`, `article_get`, `article_*`
Entregáveis	Atas de consultoria (seções em markdown)	`my_deliverables_list`, `deliverable_get`

Recurso (leitura sem ferramenta)

Recurso	URI	Descrição
Meus Sparks (resumo)	`sparkier://my/sparks-summary`	Lista dos Sparks do usuário conectado. Retorna até 50 Sparks, ordenados por data. O assistente pode descobrir e ler este recurso sem chamar uma ferramenta.

Sparks (ofertas de consultoria)

Ferramenta	Descrição
my_sparks_list	Lista os Sparks. Filtros: `publicationStatus`, `sort`, `limit`, `offset`.
sparks_get	Recupera um Spark por `id` ou `slug`.
spark_create	Cria um Spark (rascunho ou publicado se `publish: true`).
spark_update	Atualiza um Spark. Para um Spark publicado, cria uma revisão; chame `spark_publish` para tornar as alterações visíveis.
spark_publish	Publica um rascunho. Requer um perfil de consultor completo.

Perfil de consultor (página de vitrine)

Ferramenta	Descrição
my_profile_get	Recupera o perfil (mesclado com o rascunho). Retorna `hasUnpublishedDraft` se houver alterações não publicadas.
profile_draft_update	Atualiza o rascunho (nome, bio, idiomas, competências, links sociais, avaliações, missões).
profile_publish	Publica o rascunho na página de vitrine.
profile_draft_discard	Cancela o rascunho sem publicar.

Posts sociais (LinkedIn)

Ferramenta	Descrição
my_posts_list	Lista os posts. Filtros: `platform`, `status`, `limit`, `orderBy`, `orderDirection`.
post_get	Recupera um post por `postId`.
post_draft_create	Cria um rascunho de post.
post_draft_update	Atualiza um rascunho (conteúdo, url).
post_schedule	Agenda a publicação. Sem data `scheduledFor`, o Sparkier escolhe o melhor horário. Requer uma conexão LinkedIn estabelecida no Sparkier.
post_publish	Publica imediatamente no LinkedIn. Requer uma conexão LinkedIn estabelecida no Sparkier.
post_draft_discard	Exclui permanentemente um rascunho de post.

Artigos (vinculados aos Sparks)

Ferramenta	Descrição
my_articles_list	Lista os artigos. Filtros: `sparkId`, `status`, `includeArchived`, `limit`.
article_get	Recupera um artigo por `articleId`.
article_draft_create	Cria um artigo vinculado a um Spark.
article_draft_update	Atualiza um rascunho de artigo.
article_publish	Publica um artigo.
article_unpublish	Despublica (volta para rascunho).
article_archive	Arquiva (oculto das listas).

Entregáveis (atas de consultoria)

Somente leitura. Os entregáveis são atas geradas após uma sessão (seções em markdown: contexto, participantes, síntese, próximos passos, etc.).

Ferramenta	Descrição
my_deliverables_list	Lista todos os entregáveis acessíveis (missões em que você é consultor ou cliente). Cada entrada inclui `perspective`: `consultant` (produzidos, todos os status) ou `client` (recebidos, apenas `dispatched`). Contas com ambos os papéis obtêm uma lista mesclada. Nenhum parâmetro é necessário.
deliverable_get	Recupera um entregável por `deliverableId` (UUID) com título, resumo, status, seções completas em markdown, o Spark associado, a data da sessão e um link para a página do Sparkier. Consultores e administradores leem o rascunho, se existir; clientes leem apenas a versão enviada.

Exemplos de solicitações ao assistente:

Consultor: "Liste minhas atas de consultoria" → my_deliverables_list
Consultor: "Mostre-me a ata da minha última sessão com a Marie" → my_deliverables_list e depois deliverable_get
Cliente: "Quais atas eu recebi?" → my_deliverables_list
Cliente: "Resuma a ata da minha consultoria de 15 de março" → deliverable_get

Códigos de erro

As ferramentas podem retornar os seguintes códigos de erro no campo code da resposta:

Código	Quando ocorre
validation_error	Parâmetros inválidos (formato incorreto, campos obrigatórios ausentes, valores fora dos limites). Corrija a entrada e tente novamente.
role_required	O usuário não tem o papel necessário para a ação (consultor ou admin para Sparks, perfil, posts e artigos; consultor ou cliente para entregáveis).
profile_incomplete	Perfil de consultor incompleto ao tentar publicar um Spark. Peça ao usuário as informações ausentes, use `profile_draft_update` e depois `profile_publish`, e tente novamente `spark_publish`.
duplicate_title	O título do Spark corresponde a outro. Altere o título e tente novamente `spark_publish`.
duplicate_content	O conteúdo do Spark é muito semelhante a outro. Personalize o título ou o conteúdo e tente novamente `spark_publish`.
not_found	Recurso não encontrado ou não autorizado (Spark, post, artigo, etc.). Verifique o ID com a ferramenta de listagem correspondente (`my_sparks_list`, `my_posts_list`, `my_articles_list`, `my_deliverables_list`) e tente novamente.
deliverable_not_found	Entregável não encontrado. Use `my_deliverables_list` para obter um `deliverableId` válido e tente novamente `deliverable_get`.
not_dispatched	Entregável ainda não enviado ao cliente. Peça ao consultor para enviá-lo e tente novamente `deliverable_get`.
forbidden	Acesso negado a este entregável. Use `my_deliverables_list` para ver os entregáveis acessíveis.
not_published	Artigo não publicado durante um `article_unpublish`. Peça ao usuário para confirmar o artigo ou use `article_publish` primeiro.