O Artia conversa com duas ferramentas do Copilot: o GitHub Copilot CLI, no terminal, e o Microsoft Copilot Studio, que leva o Artia para agentes no Teams e no Microsoft 365 Copilot. Neste artigo, mostramos como conectar cada uma delas.

Neste artigo:

1. O que você precisa antes de começar?
2. Qual Copilot devo usar?
3. Como conectar o Artia ao GitHub Copilot CLI?
4. Como conectar o Artia ao Microsoft Copilot Studio?
5. Como usar o Artia no Teams e no Microsoft 365 Copilot?
6. E se a conexão não funcionar?

1. O que você precisa antes de começar?

Para as duas ferramentas:

E, conforme a ferramenta:

Dica: copie e cole a URL e os comandos deste artigo em vez de digitar. Um caractere diferente já faz a conexão falhar.

2. Qual Copilot devo usar?

3. Como conectar o Artia ao GitHub Copilot CLI?

1. No terminal, rode:

copilot mcp add --transport http artia https://mcp.artia.com/mcp

1. Inicie o Copilot CLI com a opção que repassa ao modelo as orientações do Artia:

copilot --allow-all-mcp-server-instructions

1. Na sessão, digite /mcp auth artia. O navegador abre o login do Artia: entre e clique em Autorizar. O servidor reconecta sozinho.

Importante: use a opção --allow-all-mcp-server-instructions sempre que abrir o Copilot CLI para trabalhar com o Artia. Sem ela, o modelo não recebe as orientações do Artia e pode escolher a organização por conta própria.

Importante: antes de aprovar uma criação ou alteração, revise os campos que o Copilot vai enviar ao Artia.

4. Como conectar o Artia ao Microsoft Copilot Studio?

Quem cria o agente adiciona o Artia uma vez, com o Client ID fixo, sem precisar pedir cadastro ao Artia.

1. No agente, abra Tools > Add a tool > New tool > Model Context Protocol. O assistente de MCP aparece.
2. Preencha:
3. • Server name: Artia
   • Server description: por exemplo, "Consulta e atualiza projetos, atividades e apontamentos de horas no Artia"
   • Server URL: https://mcp.artia.com/mcp
4. Em autenticação, escolha OAuth 2.0 e, em Type, escolha Manual. Preencha os campos com os valores da tabela abaixo.
5. Clique em Create. O Copilot Studio mostra uma callback URL: não é preciso cadastrá-la no Artia. Clique em Next.
6. Em Add tool, escolha Create a new connection. Entre no Artia e clique em Autorizar. Depois, clique em Add to agent.
7. Nas configurações da ferramenta, mantenha as credenciais do usuário final (End user credentials), para que cada pessoa use o próprio login do Artia.

Importante: use sempre as credenciais do usuário final. Com as credenciais do criador (Maker-provided credentials), todas as pessoas agiriam no Artia com as permissões de quem criou o agente.

Atenção: crie a ferramenta sempre pelo assistente de MCP. Conectores personalizados montados fora dele, no Power Apps, não completam a conexão com o Artia.

5. Como usar o Artia no Teams e no Microsoft 365 Copilot?

1. Publique o agente no canal Teams and Microsoft 365 Copilot.
2. No primeiro uso, cada pessoa conecta o próprio usuário do Artia pelo cartão de conexão que o agente mostra na conversa.

6. E se a conexão não funcionar?

Bom saber: em toda conexão nova, a tela de autorização do Artia mostra o nome da ferramenta que está se conectando. Confira o nome antes de autorizar. Se não foi você quem iniciou a conexão, clique em Cancelar.

Ficou com alguma dúvida? Nosso time de suporte está pronto para ajudar.