Neste artigo:

1. O que é o Artia MCP e como ele funciona?
2. Como instalar e configurar o Artia MCP?
3. Como utilizar o Artia MCP no dia a dia?
4. Quais as principais funcionalidades do Artia MCP?
5. Lista de todas as Funcionalidades disponíveis

1. O que é o Artia MCP e como ele funciona?

O Artia MCP é um conector que permite que assistentes de inteligência artificial, como Claude, Claude Code, Cursor e Codex, interajam diretamente com o Artia usando linguagem natural.

Com ele, você pode criar projetos, registrar atividades, apontar horas, consultar lançamentos financeiros, gerenciar equipes e muito mais, sem precisar abrir o sistema. Basta descrever o que precisa fazer e o assistente executa a ação no Artia.

O conector respeita integralmente as permissões do usuário autenticado: o assistente só acessa e modifica o que aquele usuário poderia fazer normalmente dentro do Artia.

Benefícios

• Sem necessidade de treinamento técnico: qualquer usuário do Artia pode interagir por linguagem natural, sem precisar aprender comandos ou navegar por menus.
• Acesso respeitando permissões: o assistente opera dentro dos limites de acesso do usuário logado, sem exposição de dados de outras organizações.
• Compatível com os principais assistentes de IA: Claude, Claude Code, Cursor, Codex e ChatGPT.
• Mais de 90 funcionalidades disponíveis: cobrindo projetos, atividades, horas, financeiro, equipes, arquivos, clientes e muito mais.
• Integração imediata: não exige desenvolvimento, código ou configuração avançada por parte do usuário final.
• Ações identificadas: todas as ações realizadas via MCP são sinalizadas na plataforma com a marcação "via MCP", permitindo rastreabilidade completa.

💡 Importante

O assistente de IA respeita as permissões do usuário autenticado. Ele só acessa e modifica o que esse usuário teria acesso dentro do Artia.

2. Como instalar e configurar o Artia MCP?

Pré-requisitos: Para utilizar o Artia MCP, você precisa de:

• Uma conta ativa no Artia com credenciais de acesso válidas
• A URL do conector: https://mcp.artia.com/mcp
• Um assistente de IA compatível: Claude (individual ou Teams), Claude Code, Cursor ou Codex

Instalação por ferramenta:

Claude (uso individual)

1. Acesse Configurações e clique em Conectores no Claude.ai.
2. Clique em Adicionar conector personalizado.
3. Insira a URL do conector Artia MCP e o Client ID fornecido.
4. Clique em Conectar e autorize o acesso com suas credenciais do Artia.

Utilize o Client ID correspondente ao assistente de IA que está configurando:

• Claude.ai: artia-mcp-claude
• Claude Code CLI: artia-mcp-claude-code
• ChatGPT: artia-mcp-chatgpt
• Cursor: artia-mcp-cursor
• Codex CLI: artia-mcp-codex

Claude Teams

1. O administrador da organização acessa Configurações e clique em Conectores no painel da equipe.
2. Adiciona o conector com a URL e o Client ID do Artia MCP.
3. Cada membro da equipe conecta individualmente sua conta Artia pelo mesmo fluxo de autorização.

💡 Importante

A conexão é individual. Cada membro autentica sua própria conta do Artia. O administrador não acessa dados de outros usuários.

Claude Code

1. No terminal, execute o comando de configuração do conector MCP.
2. Informe a URL do conector e o Client ID quando solicitado.
3. Autorize o acesso com suas credenciais do Artia.
4. O conector estará disponível automaticamente nas próximas sessões.

Cursor

1. Acesse Configurações e clique em MCP no Cursor.
2. Adicione um novo servidor MCP com a URL do Artia.
3. Insira o Client ID e autorize o acesso.
4. O Artia MCP aparecerá na lista de ferramentas disponíveis.

Codex

1. No painel de configurações do Codex, acesse Integrações e clique em MCP.
2. Adicione a URL do conector e o Client ID.
3. Autorize com suas credenciais do Artia.

ChatGPT

1. No terminal, execute o comando de configuração do conector MCP.
2. Informe a URL do conector e o Client ID quando solicitado.
3. Autorize o acesso com suas credenciais do Artia.
4. O conector estará disponível automaticamente nas próximas sessões.

3. Como utilizar o Artia MCP no dia a dia?

Após instalar e conectar o Artia MCP, basta conversar com o assistente de IA normalmente. Não é necessário usar linguagem técnica: descreva o que você precisa fazer e o assistente executa a ação no Artia.

Os exemplos abaixo mostram situações reais de uso por categoria. Adapte os prompts ao seu contexto substituindo os campos entre colchetes pelos dados reais.

💡 Importante

Os exemplos são pontos de partida. O assistente entende variações naturais da linguagem, então adapte conforme o seu contexto.

Projetos e Pastas

• Auditoria de projetos em risco:
• • Prompt de exemplo:
    "Liste todos os projetos em andamento com data de término prevista para os próximos 15 dias e que estejam com menos de 70% de conclusão. Ordene do mais crítico ao menos crítico."
  • Por que funciona: Antecipa atrasos antes que virem crise. A IA cruza prazo com progresso e entrega uma lista de ação imediata, sem precisar abrir nenhum filtro.

• Projetos sem movimento
• • Prompt de exemplo:
    "Quais projetos do grupo de trabalho não tiveram nenhuma atividade atualizada nos últimos 10 dias? Me mostre o responsável e a data da última modificação."
  • Por que funciona: Detecta projetos "fantasma" antes que alguém cobre resultados. Dado concreto para o gestor agir.

• Criar projeto rapidamente
• • Prompt de exemplo:
    "Crie um projeto chamado 'Implantação cliente Acme' dentro da pasta [ID], com início em [data], término previsto em [data], prioridade alta e descrição 'Onboarding e implantação do cliente Acme Corp'."
  • Por que funciona: Elimina cliques repetitivos. O projeto é criado direto no Artia com todos os campos preenchidos.

• Resumo de portfólio para reunião
• • Prompt de exemplo:
    "Resuma o status de todos os projetos em andamento: qual o percentual médio de conclusão, quantos estão dentro do prazo e quantos estão em risco de atraso?"
  • Por que funciona: Gera a visão executiva do portfólio em segundos, pronta para compartilhar em reunião.

Atividades e Tarefas

• Tarefas sem responsável
• • Prompt de exemplo:
    "Liste todas as atividades abertas do projeto [nome/ID] que estão sem responsável definido. Ordene pelas mais antigas."
  • Por que funciona: Tarefa sem dono não acontece. A IA varre o projeto e entrega a lista de atividades sem responsável para redistribuir.

• Histórico de status: onde está o gargalo?
• • Prompt de exemplo:
    "Mostre o histórico completo de status da atividade [ID]. Quanto tempo ela ficou em cada etapa? Onde está o maior gargalo do fluxo?"
  • Por que funciona: Diagnóstico de processo baseado em dados reais. Identifica onde o trabalho empaca de verdade, não onde o gestor imagina que empaca.

• Criar tarefa recorrente
• • Prompt de exemplo:
    "Crie uma atividade recorrente toda segunda-feira chamada 'Daily de alinhamento' no projeto [ID], começando em [data], sem data de término, com responsável [nome]."
  • Por que funciona: Rotinas criadas com um único comando. A recorrência fica salva no Artia sem precisar configurar semana a semana.

• Atividades em atraso real
• • Prompt de exemplo:
    "Quais atividades do projeto [nome] têm data de término no passado, mas ainda estão com status aberto? Me mostre título, responsável e quantos dias de atraso."
  • Por que funciona: Lista de atraso real sem precisar filtrar manualmente. Dado concreto para o gestor cobrar com embasamento.

• Comentar e atualizar progresso
• • Prompt de exemplo:
    "Na atividade [ID], adicione o comentário: 'Desenvolvimento concluído. Aguardando revisão de QA.' e marque o percentual de conclusão como 90%."
  • Por que funciona: Atualização rápida sem abrir o sistema. Mantém a equipe informada sem interromper o fluxo de trabalho.

Apontamentos e Horas

• Registrar horas do dia
• • Prompt de exemplo: "Registre 3 horas de trabalho para mim na atividade [ID] com a observação 'Desenvolvimento da tela de login'."
  • Por que funciona: Apontamento feito sem abrir o Artia. Útil para registrar horas no final do dia sem interromper o fluxo de trabalho.

• Consultar horas da semana
• • Prompt de exemplo: "Quantas horas eu apontei essa semana? Me mostre por projeto e atividade."
  • Por que funciona: Visão rápida do tempo investido na semana, sem precisar abrir relatórios ou filtrar listas.

• Verificar horas da equipe
• • Prompt de exemplo: "Mostre o total de horas apontadas por cada membro da equipe no projeto [nome] no mês de [mês/ano]."
  • Por que funciona: Controle de produtividade da equipe sem precisar gerar relatório manual.

• Identificar quem não apontou horas
• • Prompt de exemplo: "Quais membros da equipe não registraram nenhuma hora nos últimos 3 dias? Me mostre o nome e o último apontamento de cada um."
  • Por que funciona: Detecta gaps de registro antes do fechamento. Dado concreto para o gestor cobrar sem precisar vasculhar lista por lista.

Financeiro

• Consultar lançamentos do projeto
• • Prompt de exemplo: "Liste todos os lançamentos financeiros do projeto [nome/ID] do mês de [mês/ano]. Separe por tipo: previsto e realizado."
  • Por que funciona: Visão financeira do projeto em segundos, sem abrir filtros ou relatórios.

• Verificar margem do projeto
• • Prompt de exemplo: "Qual a margem atual do projeto [nome]? Me mostre receita prevista, receita realizada, custo previsto e custo realizado."
  • Por que funciona: Diagnóstico financeiro rápido para decisões de gestão sem precisar cruzar dados manualmente.

• Registrar lançamento financeiro
• • Prompt de exemplo: "Crie um lançamento financeiro no projeto [ID] com o título 'Licença de software', valor de R$ 1.200,00, tipo realizado, classificação gasto e data [data]."
  • Por que funciona: Lançamento criado diretamente no Artia sem precisar navegar pelos menus.

Equipes e Usuários

• Verificar disponibilidade da equipe
• • Prompt de exemplo: "Quem da equipe está disponível na semana de [data início] a [data fim]? Considere a jornada de trabalho e as ausências cadastradas."
  • Por que funciona: Planejamento de alocação baseado na disponibilidade real, sem precisar consultar calendário por calendário.

• Consultar ausências do período
• • Prompt de exemplo: "Quais membros da equipe têm ausência registrada no mês de [mês/ano]? Me mostre nome, período e tipo de ausência."
  • Por que funciona: Visão consolidada das ausências para planejar entregas e redistribuir atividades com antecedência.

• Verificar carga de trabalho
• • Prompt de exemplo: "Quantas atividades abertas cada membro da equipe do projeto [nome] tem no momento? Ordene do mais sobrecarregado ao menos sobrecarregado."
  • Por que funciona: Identifica desequilíbrio de carga antes que vire problema. Base para redistribuição de tarefas de forma justa.

Relatórios e Consultas Estratégicas

• Visão geral do portfólio
• • Prompt de exemplo: "Me dê um resumo executivo de todos os projetos ativos: status, percentual de conclusão, prazo e responsável."
  • Por que funciona: Visão de portfólio pronta para reunião de diretoria em segundos, sem montar relatório manualmente.

• Projetos por cliente
• • Prompt de exemplo: "Liste todos os projetos vinculados ao cliente [nome] com status, data de término prevista e percentual de conclusão."
  • Por que funciona: Visão consolidada por cliente para gestão de conta e atendimento sem precisar filtrar projeto a projeto.

• Análise de produtividade
• • Prompt de exemplo: "Compare o esforço estimado com o esforço real de cada atividade do projeto [nome]. Quais atividades ultrapassaram mais de 20% do estimado?"
  • Por que funciona: Diagnóstico de estimativa versus execução para calibrar planejamentos futuros com base em dados reais.

4. Quais as principais funcionalidades do Artia MCP?

Confira abaixo tudo o que é possível fazer com o Artia MCP, organizado por área:

• Atividades e Pastas
• • Criar, listar, atualizar e excluir atividades e pastas/projetos
  • Gerenciar dependências entre atividades (predecessoras e sucessoras)
  • Adicionar e remover participantes de atividades
  • Consultar tipos de pasta, status personalizados e histórico de status
• Apontamento de Horas
• • Criar, editar e excluir apontamentos de horas
  • Preencher campos personalizados configurados para apontamentos
  • Consultar seus próprios apontamentos e apontamentos por atividade
• Equipes e Usuários
• • Criar, renomear e excluir equipes
  • Adicionar e remover membros e definir o responsável da equipe
  • Convidar, suspender e atualizar usuários da organização
  • Atribuir habilidades e centros de custo a usuários
• Financeiro
• • Criar, listar, atualizar e excluir lançamentos financeiros
  • Gerenciar centros de custo
  • Registrar e consultar custos por usuário
• Ordens de Serviço
• • Criar, listar, atualizar e alterar o status de ordens de serviço
• Clientes
• • Criar, listar, atualizar e excluir clientes
• Arquivos
• • Criar arquivos e novas versões, confirmar upload e excluir
• Ausências e Comentários
• • Registrar e gerenciar ausências de usuários
  • Criar comentários e listar comentários não visualizados

5. Lista de todas as Funcionalidades disponíveis

O Artia MCP disponibiliza mais de 90 funcionalidades organizadas por módulo. Todas as ações de escrita são sinalizadas com a marcação "via MCP" na plataforma para rastreabilidade.

Projetos e Pastas

• Listar projetos Lista todos os projetos de um grupo de trabalho com status, datas e progresso.
• Exibir projeto Retorna os detalhes completos de um projeto específico.
• Criar projeto Cria um projeto com nome, datas, prioridade, responsável, campos personalizados e mais.
• Editar projeto Atualiza campos de um projeto existente.
• Excluir projeto Remove um projeto da plataforma.
• Alterar status do projeto Muda o status do projeto (ativo, pausado, encerrado etc.).
• Listar pastas: Lista todas as pastas de um grupo de trabalho.
• Criar pasta: Cria uma pasta dentro de um grupo ou projeto.
• Editar pasta: Atualiza dados de uma pasta existente.
• Excluir pasta: Remove uma ou mais pastas.
• Alterar status da pasta: Altera o status de uma pasta.
• Listar tipos de pasta: Lista os tipos de pasta disponíveis na organização.

Atividades e Tarefas

• Listar atividades: Lista as atividades de uma pasta ou projeto, com status, responsável, datas e progresso.
• Exibir atividade: Retorna os detalhes completos de uma atividade, incluindo recorrência.
• Criar atividade: Cria atividade com título, datas, responsável, prioridade, participantes, recorrência (diária, semanal ou mensal) e dependências.
• Editar atividade: Atualiza campos de uma atividade existente.
• Excluir atividades: Remove uma ou mais atividades.
• Alterar status da atividade: Muda o status de uma atividade.
• Histórico de status: Lista quanto tempo a atividade ficou em cada status, com duração em horas.
• Criar comentário: Adiciona um comentário em uma atividade.
• Ver comentários não lidos: Lista comentários ainda não visualizados pelo usuário.
• Gerenciar dependências: Cria, edita, lista e remove dependências entre atividades (FS, FF, SS, SF).

Apontamentos de Horas

• Registrar horas: Cria um apontamento de horas em uma atividade, informando data, hora de início, duração, tipo (normal ou extra) e observação.
• Listar meus apontamentos: Lista os apontamentos do usuário autenticado.
• Exibir apontamento: Retorna os detalhes de um apontamento específico.
• Editar apontamento: Atualiza dados de um apontamento existente.
• Excluir apontamento: Remove um apontamento.

Financeiro

• Listar lançamentos: Lista lançamentos financeiros (previstos e realizados) de um projeto.
• Exibir lançamento: Retorna detalhes de um lançamento financeiro específico.
• Criar lançamento: Cria um lançamento previsto ou realizado com título, valor, data e categoria.
• Editar lançamento: Atualiza um lançamento financeiro existente.
• Excluir lançamento: Remove um lançamento financeiro.
• Listar ordens de serviço: Lista as ordens de serviço de um projeto.
• Criar ordem de serviço: Cria uma OS com nome, status, responsável e descrição.
• Editar ordem de serviço: Atualiza uma OS existente.
• Alterar status da OS: Muda o status de uma ordem de serviço.
• Excluir ordem de serviço: Remove uma OS.

Clientes e Centros de Custo

• Listar clientes: Lista os clientes da organização com nome, documento e contato.
• Criar, Editar e Excluir cliente: Gerenciamento completo de clientes.
• Listar centros de custo: Lista os centros de custo do grupo de trabalho.
• Criar, Editar e Excluir centro de custo: Gerenciamento completo de centros de custo.
• Associar centro de custo ao usuário: Vincula um centro de custo a um membro da organização.
• Gerenciar custos do usuário: Cria, edita, lista e remove custos associados a um usuário.

Equipes e Usuários

• Listar membros Lista todos os membros da organização com perfil de acesso, permissões e status.
• Exibir membro Retorna detalhes de um membro específico.
• Convidar membro Envia convite para um novo usuário entrar na organização.
• Editar membro Atualiza dados de um membro da organização.
• Suspender membro Desativa o acesso de um membro sem excluí-lo.
• Listar equipes Lista todas as equipes com membros e responsável.
• Criar, Editar e Excluir equipe Gerenciamento completo de equipes.
• Adicionar e Remover usuário da equipe Gerencia membros de uma equipe específica.
• Gerenciar ausências Cria, edita, lista e remove ausências de usuários.

Arquivos e Anexos

• Listar arquivos Lista arquivos anexados a um projeto, pasta ou atividade.
• Criar arquivo Inicia o upload de um novo arquivo.
• Nova versão Cria uma nova versão de um arquivo existente.
• Editar metadados Atualiza título e descrição de um arquivo.
• Excluir arquivo Remove um arquivo da plataforma.

Personalização e Configurações

• Listar campos personalizados Lista os campos customizados disponíveis na organização.
• Listar status personalizados Lista os status customizados configurados.
• Listar categorias personalizadas Lista as categorias customizadas disponíveis.
• Selecionar organização Muda a organização ativa para usuários com acesso a mais de uma organização.
• Organização atual Retorna os dados da organização ativa no momento.
• Data atual Retorna a data e hora atual do sistema.

💡 Importante

Todas as ações de criação e edição realizadas via MCP são identificadas com a marcação "via MCP" na plataforma, garantindo rastreabilidade completa das operações executadas pelo assistente.

Ainda tem dúvidas? Fale com um de nossos consultores pelo chat em artia.com ou pelo e-mail [email protected].