Quire (Pré-visualização)

Gerir projetos, tarefas, comentários, etiquetas, sublistas e estados do Quire a partir do Microsoft Copilot Studio. O servidor MCP do Quire liga os agentes do Copilot Studio ao espaço de trabalho do Quire através do Protocolo de Contexto do Modelo — os agentes podem ler e pesquisar projetos e tarefas, criar e atualizar itens de trabalho, publicar comentários e agir em nome do utilizador usando as suas próprias credenciais do Quire.

Este conector está disponível nos seguintes produtos e regiões:

O Quire é uma plataforma de colaboração visual construída para dividir sonhos em tarefas exequíveis — sprints ágeis, sublistas aninhadas, quadros Kanban, gráficos de Gantt, calendários e OKRs, tudo num só espaço de trabalho. Este conector liga Microsoft Copilot Studio agentes ao Quire através do Model Context Protocol (MCP), para que os agentes possam ler e pesquisar projetos e tarefas, criar e atualizar itens de trabalho, publicar comentários, gerir etiquetas e sublistas, e agir em nome do utilizador usando as suas próprias credenciais Quire.

Por baixo do capot, o conector expõe uma única InvokeServer ação que tem como alvo o endpoint MCP streamable em https://mcp.quire.app/mcp. O wrapper MCP da Copilot Studio trata do handshake initialize → notifications/initialized → tools/list → tools/call por cima dessa entrada HTTP — o agente vê um conector mas invoca qualquer uma das ferramentas ~80 Quire que o servidor anuncia.

Pré-requisitos

• Uma conta na Quire — a versão gratuita funciona.
• A participação em pelo menos uma organização ou projeto da Quire em que o agente deve atuar. O conector autentica-se como utilizador iniciado sessão, pelo que o agente herda exatamente as permissões desse utilizador.
• Para organizações com um plano pago da Quire, o proprietário do espaço de trabalho deve permitir aplicações OAuth de terceiros. (Os espaços de trabalho pessoais e gratuitos têm isto ativado por defeito.)

Como obter credenciais

Os utilizadores finais iniciam sessão na sua própria conta Quire durante a configuração da ligação — não existe uma chave API para copiar ou colar.

1. No Copilot Studio (ou Power Apps / Power Automate), adicione o conector Quire ao seu agente ou fluxo.
2. Quando solicitado, clique em Iniciar sessão. Abre um separador do navegador para https://mcp.quire.app/authorize.
3. A página de consentimento Quire OAuth lista os espaços de trabalho a que este conector poderá aceder. Aprove o pedido.
4. O navegador fecha e Copilot Studio mostra a ligação como Connected.

Os tokens de acesso são válidos por ~1 hora e são atualizados automaticamente pela Power Platform usando o URL de atualização do conector.

Introdução ao conector

Uma vez ligado, o conector expõe uma única ação da Power Platform — Invocar o Servidor — mas todas as ferramentas MCP do Quire são acessíveis através dele através do agente. O agente irá escolher a ferramenta certa para cada instrução do utilizador.

Coisas representativas que o agente pode fazer por si:

• Encontre trabalho: "O que está em atraso na organização de Marketing?", "Mostre-me tarefas que me foram atribuídas esta semana", "Procure tarefas marcadas como 'urgentes' no projeto de Design."
• Criar e atualizar: "Cria uma tarefa 'Rascunho do deck de lançamento do 3.º trimestre' em Marketing/Campanhas com entrega na próxima sexta-feira e atribui-me isso.", "Marca o Roadmap #842 como Não Vai Corrigir.", "Mover todas as tarefas em aberto na sublista de Backlog para Em Progresso."
• Colaborar: "Comentário sobre a tarefa #1204 que revisei e aprovei a especificação.", "Adicione o Bob como seguidor em todas as tarefas abertas na sublista de Revisão de Design."
• Organizar: "Criar uma nova sublista 'Fase 2' na sublista de Migração.", "Renomear a etiqueta 'P1' para 'Alta Prioridade' em toda a organização."

Para uma referência completa das operações expostas pelo servidor Quire MCP, consulte a documentação do servidor Quire MCP.

Problemas e limitações conhecidos

• Um utilizador por ligação. Cada ligação autentica um único utilizador Quire; Partilhar uma ligação entre utilizadores significa que as ações aparecem como proprietárias da ligação. Prever uma ligação por utilizador (o padrão no Copilot Studio).
• Apenas HTTP transmitível. Este conector utiliza o wrapper MCP da Power Platform com x-ms-agentic-protocol: mcp-streamable-1.0. Os clientes MCP apenas SSE não são relevantes aqui — a Power Platform é a proprietária do transporte.
• As funcionalidades de planos pagos poderão surgir 403. Algumas operações de escrita do Quire (categorias de aprovação personalizadas, campos de projeto no free tier, etc.) requerem um plano pago do Quire; O conector reporta a mensagem de erro do servidor literalmente. Atualiza o espaço de trabalho Quire, não a configuração do conector.

Erros e soluções comuns

• invalid_request — Missing required parameters durante o início de sessão: certifique-se de que o ambiente do seu inquilino não está a bloquear o host mcp.quire.app através de uma política DLP que exige IDPs OAuth apenas Microsoft.
• HTTP 469 (ecQuotaExceeded) numa chamada de ferramenta: o espaço de trabalho Quire atingiu a sua quota de API. Espera que a janela da quota reinicie (normalmente uma hora) ou melhora o plano Quire.
• Unknown client_id ao reconectar: o registo do cliente Quire MCP OAuth foi revogado ou rodado. Desligue a ligação no Copilot Studio e volte a ligar — o Power Platform regista-se automaticamente.
• PKCE verification failed para o fluxo de navegador orientado para o utilizador: não modifique o URL de Autorização dentro da configuração do conector. O Copilot Studio constrói o pedido OAuth; as edições manuais eliminam os parâmetros necessários.

Para tudo o que não foi abordado acima, envie um email support@quire.io.

FAQ

Este conector usa diretamente a API Quire REST? Não — utiliza o servidor MCP do Quire (https://mcp.quire.app), que assenta sobre a API do Quire e expõe uma superfície orientada para ferramentas desenhada para agentes LLM. Este é o mesmo servidor que alimenta as integrações Claude, Cursor e ChatGPT MCP.

Onde são guardados os tokens? Os tokens de atualização são armazenados encriptados pelo framework de conectores do Power Platform; o servidor MCP Quire armazena o seu próprio token de atualização para a conta Quire do utilizador na sua base de dados, com âmbito apenas para esse utilizador. Nenhum dos lados mantém o token de acesso Power Platform.

O agente consegue aceder à minha caixa de entrada privada ("As Minhas Tarefas")? Sim — a Caixa de Entrada do Quire faz parte do âmbito As Minhas Tarefas. Pede ao agente "tarefas na minha caixa de entrada" ou "o que está na minha lista de Minhas Tarefas" e ele irá passar pela ferramenta MCP apropriada.

Existe algum sandbox / espaço de trabalho de desenvolvimento contra o qual possa testar? Crie uma conta gratuita no Quire em https://quire.io. Os espaços de trabalho gratuitos suportam toda a superfície da ferramenta de ligação — funcionalidades pagas são necessárias apenas para fluxos de trabalho de aprovação a nível organizacional e para alguns campos de insights.

Limites de Limitação

Ações

Quire