Conecte um agente pelo MCP do ClickUpfy

O servidor MCP do ClickUpfy disponibiliza ferramentas para um cliente de IA. O processo usa a configuração de perfil do CLI e exige a List do projeto.

Comece com consulta

Substitua o ID de exemplo por uma List autorizada. Para conferir a inicialização do servidor, o comando é:

1
clickupfy mcp serve --list ID_DA_LIST --read-only

O transporte stdio espera que o cliente MCP converse com esse processo. Ele não abre uma interface web. O modo read-only disponibiliza as ferramentas de consulta e não registra ferramentas de escrita.

Configure o cliente

Cadastre clickupfy como comando do servidor e passe mcp, serve, –list, o ID e –read-only como argumentos separados. Use a documentação do ClickUpfy para o formato do cliente adotado pelos participantes do projeto.

O objeto abaixo demonstra essa separação:

1
{
2
  "command": "clickupfy",
3
  "args": ["mcp", "serve", "--list", "ID_DA_LIST", "--read-only"]
4
}

O objeto demonstra comando e argumentos. O local desse objeto no arquivo de configuração depende do cliente MCP adotado. Substitua o ID e use o formato documentado pelo cliente, sem colar a linha inteira do terminal como nome do executável.

Confira o processo usado pelo cliente

O cliente precisa encontrar o ClickUpfy e acessar o perfil configurado no ambiente que inicia o processo. Uma consulta que funciona no seu terminal não comprova que um aplicativo iniciado de outra forma recebeu o mesmo PATH ou a mesma configuração.

Quando a conexão falhar, confira o caminho do executável e os registros de inicialização do cliente. Confira também se o aplicativo recebeu as variáveis de ambiente necessárias ao perfil.

Confira o alcance

Peça ao cliente para consultar o destino configurado no MCP e uma tarefa de estudo. Confirme perfil, Workspace e List. A configuração da List orienta as ferramentas de tarefas. Recursos de Docs têm alcance de Workspace, conforme o contrato do projeto.

Quando a aplicação exigir escrita, defina as operações permitidas antes de habilitá-las. Releia cada recurso alterado para conferir o resultado.