Servidor MCP Trello | Awesome MCP Servers

Trello MCP

Um servidor Model Context Protocol (MCP) que fornece integração abrangente com o Trello para qualquer cliente compatível com MCP — incluindo Claude Desktop, Claude Code, Gemini CLI e outros. Este servidor permite que assistentes de IA interajam com quadros, cartões, listas e muito mais do Trello por meio de uma conexão local segura.

Recursos

🔍 Busca e Descoberta

Busca Universal: Pesquise em todo o conteúdo do Trello (quadros, cartões, membros, organizações)
Quadros do Usuário: Obtenha todos os quadros acessíveis ao usuário atual
Detalhes do Quadro: Recupere informações detalhadas sobre quadros, incluindo listas e cartões

📝 Gerenciamento de Cartões

Criar Cartões: Adicione novos cartões a qualquer lista com descrições, datas de vencimento e atribuições
Atualizar Cartões: Modifique propriedades dos cartões, como nome, descrição, datas de vencimento e status
Mover Cartões: Transfira cartões entre listas para atualizar o status do fluxo de trabalho
Obter Detalhes do Cartão: Busque informações completas do cartão, incluindo membros, etiquetas e checklists

💬 Colaboração

Adicionar Comentários: Publique comentários em cartões para comunicação da equipe
Gerenciamento de Membros: Visualize membros do quadro e detalhes dos membros
Histórico de Atividades: Acompanhe ações e alterações nos cartões

📋 Organização

Gerenciamento de Listas: Crie novas listas e obtenha cartões em listas específicas
Etiquetas: Visualize e gerencie etiquetas do quadro para categorização
Checklists: Acesse checklists de cartões e itens de checklist
Anexos: Visualize anexos de cartões e arquivos vinculados

Instalação

Pré-requisitos

Node.js 18+ instalado
Um cliente compatível com MCP (Claude Desktop, Claude Code, Gemini CLI, etc.)
Conta no Trello com credenciais de API

Etapas de Configuração

Clone o repositório

git clone https://github.com/kocakli/trello-desktop-mcp.git
cd trello-desktop-mcp

Instale as dependências
```
npm install
```
Compile o projeto
```
npm run build
```
Obtenha as credenciais da API do Trello
- Acesse https://trello.com/app-key
- Copie sua Chave de API
- Gere um Token (nunca expira, acesso de leitura/escrita)

Configure seu cliente MCP

Escolha as instruções para o seu cliente abaixo:

Claude Desktop

Edite o arquivo de configuração do Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Adicione o servidor Trello MCP:

{
  "mcpServers": {
    "trello": {
      "command": "node",
      "args": ["/absolute/path/to/trello-desktop-mcp/dist/index.js"],
      "env": {
        "TRELLO_API_KEY": "your-api-key-here",
        "TRELLO_TOKEN": "your-token-here"
      }
    }
  }
}

Em seguida, reinicie o Claude Desktop.

Claude Code (CLI)

Adicione o servidor usando a CLI do Claude Code:

claude mcp add trello -- node /absolute/path/to/trello-desktop-mcp/dist/index.js \
  -e TRELLO_API_KEY=your-api-key-here \
  -e TRELLO_TOKEN=your-token-here

Ou adicione ao .mcp.json do seu projeto:

{
  "mcpServers": {
    "trello": {
      "command": "node",
      "args": ["/absolute/path/to/trello-desktop-mcp/dist/index.js"],
      "env": {
        "TRELLO_API_KEY": "your-api-key-here",
        "TRELLO_TOKEN": "your-token-here"
      }
    }
  }
}

Gemini CLI

Edite o arquivo de configurações do Gemini CLI em ~/.gemini/settings.json:

{
  "mcpServers": {
    "trello": {
      "command": "node",
      "args": ["/absolute/path/to/trello-desktop-mcp/dist/index.js"],
      "env": {
        "TRELLO_API_KEY": "your-api-key-here",
        "TRELLO_TOKEN": "your-token-here"
      }
    }
  }
}

Outros Clientes MCP

Qualquer cliente compatível com MCP que suporte transporte stdio pode usar este servidor. Você precisa configurá-lo para:

Executar node /absolute/path/to/trello-desktop-mcp/dist/index.js
Definir as variáveis de ambiente TRELLO_API_KEY e TRELLO_TOKEN

Consulte a documentação do seu cliente para o formato exato de configuração.

Reinicie seu cliente MCP para aplicar a nova configuração.

Ferramentas Disponíveis

O servidor MCP fornece 19 ferramentas organizadas em três fases:

Fase 1: Ferramentas Essenciais

trello_search - Busca universal em todo o conteúdo do Trello
trello_get_user_boards - Obtenha todos os quadros acessíveis ao usuário atual
get_board_details - Obtenha informações detalhadas do quadro com listas e cartões
get_card - Obtenha detalhes completos do cartão
create_card - Crie novos cartões em qualquer lista

Fase 2: Operações Principais

update_card - Atualize propriedades do cartão
move_card - Mova cartões entre listas
trello_add_comment - Adicione comentários a cartões
trello_get_list_cards - Obtenha todos os cartões em uma lista específica
trello_create_list - Crie novas listas em quadros

Fase 3: Recursos Avançados

trello_get_board_cards - Obtenha todos os cartões de um quadro com filtros
trello_get_card_actions - Obtenha o histórico de atividades do cartão
trello_get_card_attachments - Obtenha anexos do cartão
trello_get_card_checklists - Obtenha checklists do cartão
trello_get_board_members - Obtenha membros do quadro
trello_get_board_labels - Obtenha etiquetas do quadro
trello_get_member - Obtenha detalhes do membro

Ferramentas Legadas (Compatibilidade Reversa)

list_boards - Liste os quadros do usuário
get_lists - Obtenha listas em um quadro

Exemplos de Uso

Após a configuração, você pode usar linguagem natural com seu assistente de IA para interagir com o Trello:

"Show me all my Trello boards"
"Create a new card called 'Update documentation' in the To Do list"
"Move card X from In Progress to Done"
"Add a comment to card Y saying 'This is ready for review'"
"Search for all cards with 'bug' in the title"
"Show me all cards assigned to me"

Arquitetura

Protocolo MCP

O servidor implementa o Model Context Protocol (MCP), que fornece:

Descoberta e invocação padronizadas de ferramentas
Validação de parâmetros com segurança de tipos
Tratamento estruturado de erros
Gerenciamento automático de credenciais

Segurança

As credenciais da API são armazenadas localmente na configuração do seu cliente MCP
Nenhuma credencial é transmitida pela rede
Todas as chamadas à API do Trello usam HTTPS
A limitação de taxa é respeitada com lógica automática de nova tentativa

Stack Técnica

TypeScript para segurança de tipos
MCP SDK para implementação do protocolo
Zod para validação de esquemas
Fetch API para requisições HTTP

Desenvolvimento

Estrutura do Projeto

├── src/
│   ├── index.ts          # Main MCP server entry point
│   ├── server.ts         # Alternative server implementation
│   ├── tools/            # Tool implementations
│   │   ├── boards.ts     # Board-related tools
│   │   ├── cards.ts      # Card-related tools
│   │   ├── lists.ts      # List-related tools
│   │   ├── members.ts    # Member-related tools
│   │   ├── search.ts     # Search functionality
│   │   └── advanced.ts   # Advanced features
│   ├── trello/           # Trello API client
│   │   └── client.ts     # API client with retry logic
│   ├── types/            # TypeScript type definitions
│   └── utils/            # Utility functions
├── dist/                 # Compiled JavaScript
└── package.json          # Project configuration

Compilando a partir do Código-Fonte

# Install dependencies
npm install

# Build the project
npm run build

# Run type checking
npm run type-check

Testes

O servidor inclui tratamento abrangente de erros e validação. Teste sua configuração:

Verificando o status da conexão do seu cliente MCP
Executando um comando simples como "Mostre meus quadros do Trello"
Confirmando que a resposta inclui seus dados do quadro

Solução de Problemas

Problemas Comuns

"Nenhuma ferramenta do Trello disponível"
- Certifique-se de que seu cliente MCP foi totalmente reiniciado após a configuração
- Verifique se o caminho na configuração aponta para dist/index.js
- Confirme se o arquivo existe e foi compilado
"Credenciais inválidas"
- Revise sua chave de API e token
- Certifique-se de que o token tenha permissões de leitura/escrita
- Regere o token, se necessário
"Limite de taxa excedido"
- O servidor inclui lógica automática de nova tentativa
- Aguarde alguns minutos se atingir os limites
- Considere reduzir a frequência das requisições

Registro de Depuração

Verifique os logs do seu cliente MCP para obter detalhes de conexão e erros. Para o Claude Desktop, os logs estão em:

macOS: ~/Library/Logs/Claude/mcp-server-trello.log
Windows: %APPDATA%\Claude\Logs\mcp-server-trello.log

Contribuindo

Contribuições são bem-vindas! Por favor:

Faça um fork do repositório
Crie um branch de funcionalidade
Adicione testes para novas funcionalidades
Envie um pull request

Licença

Licença MIT - consulte o arquivo LICENSE para detalhes

Agradecimentos

Construído com o Model Context Protocol SDK
Utiliza a Trello REST API
Compatível com Claude Desktop, Claude Code, Gemini CLI e outros clientes MCP

Trello MCP

Documentação

Trello MCP

Recursos

🔍 Busca e Descoberta

📝 Gerenciamento de Cartões

💬 Colaboração

📋 Organização

Instalação

Pré-requisitos

Etapas de Configuração

Ferramentas Disponíveis

Fase 1: Ferramentas Essenciais

Fase 2: Operações Principais

Fase 3: Recursos Avançados

Ferramentas Legadas (Compatibilidade Reversa)

Exemplos de Uso

Arquitetura

Protocolo MCP

Segurança

Stack Técnica

Desenvolvimento

Estrutura do Projeto

Compilando a partir do Código-Fonte

Testes

Solução de Problemas

Problemas Comuns

Registro de Depuração

Contribuindo

Licença

Agradecimentos