Ligar o Syntra ao Claude e ao ChatGPT
O conector do Syntra permite ao Claude e ao ChatGPT trabalhar com o seu espaço Syntra através do protocolo aberto Model Context Protocol (MCP). Pergunte por projetos, tarefas, riscos e sprints por palavras suas e, onde o seu espaço o permitir, deixe o assistente criá-los e atualizá-los por si.
Requisitos
- Uma conta Syntra que seja membro de um espaço num plano pago: Starter, Business ou Enterprise. A leitura pelo Claude e pelo ChatGPT está incluída em qualquer plano pago; a escrita vem com o plano Enterprise, juntamente com a API e os webhooks. Veja os preços.
- Claude (qualquer plano que suporte conectores) ou ChatGPT (um plano que permita adicionar um servidor MCP personalizado).
- Nada a instalar, nenhuma app OAuth a registar, nenhum client ID nem chave de API a criar. Inicia sessão no Syntra no browser, escolhe o espaço e autoriza o acesso uma única vez.
Endereço do servidor: https://syntra.tymko.tech/mcp. O espaço escolhe-se na página de consentimento, ao ligar. Se pertencer a vários espaços e preferir um conector próprio para cada um, pode usar em vez disso o endereço do próprio espaço, https://syntra.tymko.tech/mcp/<workspace>, indicado no Syntra na página de API do espaço. É opcional.
Ligar no Claude
O Syntra está no diretório de conectores do Claude (Claude Connectors Directory) como conector da comunidade. O Claude identifica-se automaticamente junto do Syntra com um Client ID Metadata Document, por isso não há app OAuth, client ID nem chave de API a configurar. O conector funciona no Claude na web, no Claude Desktop e nas apps para telemóvel.
- Encontre o Syntra.No Claude, abra Customize (ou Settings) → Connectors, pesquise Syntra e clique em Connect. Também pode abrir diretamente a página do Syntra.
- Inicie sessão no Syntra.Abre-se uma janela do Syntra; inicie sessão com a sua conta Syntra (e com o segundo fator, se estiver ativado).
- Escolha o espaço e permita o acesso.A página de consentimento mostra a app (Claude, claude.ai), o seu utilizador, o nível de acesso e para onde será reencaminhado. Se pertencer a vários espaços, escolha um e clique em «Permitir».
- Pergunte.Numa nova conversa, pergunte pelos seus projetos. O Claude chama as ferramentas do Syntra e mostra cada chamada que faz.
O Claude Code liga-se da mesma forma: claude mcp add --transport http syntra https://syntra.tymko.tech/mcp e depois execute /mcp para iniciar sessão.
Ligar no ChatGPT
- Adicione um servidor MCP personalizado.No ChatGPT, abra Plugins (Settings → Apps), clique em Add e depois em Add custom MCP server. Introduza o URL
https://syntra.tymko.tech/mcpe escolha OAuth como autenticação. - Inicie sessão e permita.O ChatGPT identifica-se automaticamente, por isso não há nada a registar no Syntra. Inicie sessão no Syntra, escolha o espaço e clique em «Permitir» na mesma página de consentimento que para o Claude; nela a app aparece como ChatGPT (chatgpt.com).
- Use-o numa conversa.Mencione o Syntra ou escolha-o no menu de ferramentas e faça a sua pergunta.
O Syntra ainda não está no diretório de apps do ChatGPT, por isso, por agora, é adicionado como servidor MCP personalizado.
Outros clientes MCP
Outros clientes que suportam servidores MCP remotos ligam-se a https://syntra.tymko.tech/mcp com OAuth através de uma app OAuth registada nas definições do espaço, no separador «API»: o mesmo início de sessão e a mesma página de consentimento descritos acima. Os clientes que enviam os seus próprios cabeçalhos podem usar em vez disso uma chave de acesso do Syntra, como Authorization: Bearer syn_…. Por exemplo, o Claude Code com uma chave: claude mcp add --transport http syntra https://syntra.tymko.tech/mcp --header "Authorization: Bearer syn_…". Os proprietários e administradores do espaço emitem chaves nas definições do espaço, no separador «API»; qualquer membro pode criar uma chave pessoal em «Configurações» → «Chaves de API». As apps OAuth e as chaves de acesso vêm com o plano Enterprise.
Ferramentas
Todas as ligações recebem as ferramentas de leitura. As ferramentas de escrita só aparecem no plano Enterprise, quando a escrita está ativada para o espaço e escolheu «leitura e escrita» na página de consentimento. Nenhuma ferramenta pode eliminar nada.
| Ferramenta | O que faz |
|---|---|
list_projects | Projetos que pode ver: código, nome, estado, progresso, prioridade, trimestre, líder, prazo, departamento, semáforos de saúde, riscos em aberto. Só leitura. |
get_project | Um projeto completo: descrição, orçamento, semáforos de saúde, tarefas por estado, as próprias tarefas e os riscos com a respetiva mitigação. Só leitura. |
list_tasks | Tarefas de todos os seus projetos ou de um só, das alterações mais recentes para as mais antigas, filtradas por projeto, estado, responsável, sprint ou data de alteração. Só leitura. |
list_sprints | Sprints por departamento com datas, estado, número de tarefas e Story Points. Só leitura. |
get_sprint | Um sprint completo: objetivo, Story Points, as suas tarefas e o burndown. Só leitura. |
whoami | Em nome de que utilizador e de que espaço a ligação atua, e com que papel. Só leitura. |
create_task | Cria uma tarefa ou um relatório de bug num projeto, em seu nome. Escrita. |
update_task | Altera uma tarefa: título, descrição, estado, responsável, prazo, etiquetas, Story Points, sprint. Escrita. |
add_task_comment | Adiciona um comentário a uma tarefa; o responsável e o líder do projeto são notificados. Escrita. |
create_project | Cria um projeto com descrição, estado, prioridade, trimestre, prazo e líder. Escrita. |
update_project | Altera os campos, os semáforos de saúde ou o orçamento de um projeto. Escrita. |
add_risk | Regista um risco num projeto, com a sua gravidade e mitigação. Escrita. |
update_risk | Altera o texto, a gravidade, a mitigação ou o estado de um risco (fechar ou reabrir). Escrita. |
create_sprint | Planeia um novo sprint para um departamento. Escrita. |
update_sprint | Altera o nome, o objetivo ou as datas de um sprint planeado ou ativo. Escrita. |
Exemplos de pedidos
- «Que projetos estão atrasados neste trimestre, e porquê?»
- «O que mudou nos projetos de marketing desde segunda-feira?»
- «Como está a correr o sprint atual? Mostra o burndown e o que ainda está em aberto.»
- «Quem tem mais tarefas em atraso neste momento?»
- «Cria um bug no projeto P-117: o botão de checkout não faz nada no iOS, com os passos para reproduzir.»
- «Adiciona um risco alto ao P-131: o fornecedor pode falhar a data de lançamento; mitigação: um segundo fornecedor.»
Permissões
- Os seus direitos, nada mais. O assistente atua em seu nome no espaço escolhido e vê exatamente o que o seu papel permite; os projetos restritos ficam ocultos se não os puder abrir.
- Leitura para todos os membros. Os membros de espaços em qualquer plano pago (Starter, Business ou Enterprise) podem ligar-se e ler.
- Escrita no Enterprise, quando ambos o permitem. As ferramentas de escrita só funcionam no plano Enterprise, quando um superadmin do Syntra ativou a escrita via MCP para o espaço (o proprietário pede-o ao suporte) e escolheu «leitura e escrita» na página de consentimento. Caso contrário, a ligação é só de leitura, independentemente do que o assistente peça.
- Sem eliminações. Nenhuma ferramenta elimina projetos, tarefas, riscos, sprints ou comentários.
- Só para o conector. Os tokens emitidos para o Claude e o ChatGPT só servem para a ligação MCP, não para o resto da API do Syntra.
- Alterações visíveis. As alterações feitas através do conector aparecem no Syntra com o seu nome, no histórico da tarefa e do projeto e no registo de auditoria.
Privacidade e dados
O Syntra envia ao assistente apenas os resultados das ferramentas que este chama, limitados ao que pode ver. O Syntra não recebe nem guarda as suas conversas com o Claude ou o ChatGPT; o que o assistente faz com os resultados das ferramentas rege-se pelos termos da Anthropic ou da OpenAI aplicáveis à sua conta. O início de sessão usa OAuth 2.0 com PKCE: o assistente nunca vê a sua palavra-passe do Syntra, e o Syntra guarda apenas hashes dos tokens que emite. Os detalhes estão na política de privacidade, na lista de subcontratantes e no DPA.
Desligar
Remova o conector no Claude ou no ChatGPT e revogue o consentimento no Syntra em «Configurações» → «Chaves de API» → «As minhas permissões». Cada membro faz isto para o seu próprio acesso. A partir daí, o refresh token do assistente deixa de funcionar de imediato e o access token atual expira no prazo de 24 horas. O proprietário de um espaço também pode pedir ao suporte que desative a escrita para todo o espaço.
Resolução de problemas
«Não há nenhum espaço ao qual possa ligar esta app»
Nenhum dos seus espaços está num plano pago, ou o endereço do espaço no URL do conector é de um espaço do qual não é membro. Fale com o proprietário do espaço ou ligue-se com o endereço geral https://syntra.tymko.tech/mcp.
O assistente diz que a ligação é só de leitura
O espaço não está no plano Enterprise, a escrita está desativada para ele ou escolheu só leitura. A escrita exige o plano Enterprise; peça ao proprietário que mande ativar a escrita, depois desligue, volte a ligar e escolha «leitura e escrita» na página de consentimento.
Falta um projeto nas respostas
Peça ao assistente que execute whoami: mostra o utilizador, o espaço e o papel com que a ligação atua. Os projetos que não consegue abrir no Syntra também não são visíveis para o assistente.
Suporte
Escreva para support@tymko.tech indicando a hora do problema e, se possível, o nome da ferramenta que o assistente mostrou.