Trello

Integra-se ao Trello para gerenciar projetos, quadros e cartões, utilizando o Nango para autenticação.

GitHub
1

Documentação

Trello MCP Server

Um servidor Model Context Protocol (MCP) que fornece integração perfeita entre Claude e Trello via autenticação Nango. Este servidor permite que o Claude interaja com seus quadros, listas, cartões e muito mais do Trello por meio de comandos em linguagem natural.

🚀 Funcionalidades

  • Cobertura completa da API do Trello: Gerencie quadros, listas, cartões, comentários e anexos
  • Autenticação segura: Usa Nango para autenticação OAuth com o Trello
  • Operações em tempo real: Crie, leia, atualize e exclua itens do Trello instantaneamente
  • Funcionalidade de pesquisa: Pesquise em quadros, cartões e membros
  • Tratamento de erros: Tratamento robusto de erros com atualização automática de credenciais

📋 Ferramentas Disponíveis

Operações de Quadro

  • trello_get_my_boards - Obtenha todos os seus quadros
  • trello_get_board - Obtenha detalhes específicos de um quadro
  • trello_create_board - Crie novos quadros
  • trello_update_board - Atualize informações do quadro
  • trello_delete_board - Exclua quadros
  • trello_get_board_lists - Obtenha todas as listas de um quadro
  • trello_get_board_cards - Obtenha todos os cartões de um quadro
  • trello_get_board_members - Obtenha os membros do quadro

Operações de Lista

  • trello_create_list - Crie novas listas
  • trello_update_list - Atualize detalhes da lista
  • trello_archive_list - Arquive listas
  • trello_get_list_cards - Obtenha cartões em uma lista específica

Operações de Cartão

  • trello_create_card - Crie novos cartões
  • trello_get_card - Obtenha detalhes do cartão
  • trello_update_card - Atualize cartões (incluindo mover entre listas)
  • trello_delete_card - Exclua cartões
  • trello_add_comment_to_card - Adicione comentários aos cartões
  • trello_add_attachment_to_card - Adicione anexos aos cartões

Pesquisa e Descoberta

  • trello_search - Pesquise no Trello por quadros, cartões, membros, etc.

🛠️ Instalação

Pré-requisitos

  1. Python 3.13+ instalado no seu sistema
  2. Conta Nango com integração do Trello configurada
  3. Credenciais da API do Trello (ID do Cliente)

Passo 1: Clone e Configuração

git clone <your-repo-url>
cd trello-mcp

Passo 2: Instale as Dependências

Usando UV (recomendado):

uv sync

Ou usando pip:

pip install -e .

Passo 3: Configuração do Ambiente

Crie um arquivo .env na raiz do projeto:

# Nango Configuration
NANGO_BASE_URL=https://api.nango.dev
NANGO_SECRET_KEY=your_nango_secret_key_here
NANGO_CONNECTION_ID=your_user_connection_id
NANGO_INTEGRATION_ID=trello

# Trello Configuration
TRELLO_CLIENT_ID=your_trello_api_key_here

# Optional: Enable debug mode
DEBUG=false

Passo 4: Configure o Claude Desktop

Adicione a seguinte configuração ao arquivo de configuração do Claude Desktop:

Localização do arquivo de configuração:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "trello": {
      "command": "uvx",
      "args": ["git+https://github.com/Shameerpc5029/trello-mcp.git"],
      "env": {
        "NANGO_BASE_URL": "https://api.nango.dev",
        "NANGO_SECRET_KEY": "your_nango_secret_key_here",
        "NANGO_CONNECTION_ID": "your_user_connection_id",
        "NANGO_INTEGRATION_ID": "trello",
        "TRELLO_CLIENT_ID": "your_trello_api_key_here"
      }
    }
  }
}

🔧 Guia de Configuração

Obtendo Suas Credenciais

1. Configuração do Nango

  1. Cadastre-se em Nango.dev
  2. Crie uma nova integração para o Trello
  3. Configure as configurações de OAuth
  4. Obtenha seu NANGO_SECRET_KEY no painel
  5. Configure uma conexão e anote o NANGO_CONNECTION_ID

2. Chave da API do Trello

  1. Acesse o Portal do Desenvolvedor do Trello
  2. Obtenha sua Chave da API (isso se torna seu TRELLO_CLIENT_ID)

Testando a Instalação

  1. Teste o servidor diretamente:

    uv run trello-mcp

  2. Verifique o Claude Desktop:

    • Reinicie o Claude Desktop
    • Procure pelas ferramentas do Trello na paleta de ferramentas
    • Tente perguntar: "Mostre-me meus quadros do Trello"

💡 Exemplos de Uso

Após a configuração, você pode interagir com o Trello por meio do Claude usando linguagem natural:

Operações Básicas

  • "Mostre-me todos os meus quadros do Trello"
  • "Crie um novo quadro chamado 'Planejamento de Projeto'"
  • "Quais listas estão no meu quadro 'Tarefas de Trabalho'?"
  • "Adicione um cartão chamado 'Revisar PR' à lista 'A Fazer'"

Operações Avançadas

  • "Mova o cartão 'Correção de Bug' de 'Em Andamento' para 'Concluído'"
  • "Adicione um comentário ao cartão sobre atualizar a documentação"
  • "Pesquise todos os cartões contendo 'urgente'"
  • "Crie uma nova lista chamada 'Bloqueado' no meu quadro de projeto atual"

Gerenciamento de Projetos

  • "Configure um novo quadro de projeto com listas: Backlog, A Fazer, Em Andamento, Revisão, Concluído"
  • "Mostre-me todos os cartões atribuídos a mim em todos os quadros"
  • "Arquive a lista da sprint concluída"

🔍 Solução de Problemas

Problemas Comuns

  1. Erro de "variáveis de ambiente obrigatórias ausentes"

    • Certifique-se de que todas as variáveis obrigatórias estejam definidas no seu arquivo .env
    • Verifique se a configuração no Claude Desktop corresponde ao seu ambiente

  2. Falhas de autenticação

    • Verifique se sua integração Nango está configurada corretamente
    • Confirme se sua chave da API do Trello está correta
    • Garanta que a conexão Nango esteja ativa

  3. Servidor não aparecendo no Claude

    • Reinicie o Claude Desktop após alterações na configuração
    • Verifique se o caminho do arquivo na configuração do Claude está correto
    • Confirme se o comando uv está disponível no seu PATH

  4. Falha na execução da ferramenta

    • Verifique os logs do servidor para mensagens de erro detalhadas
    • Confirme se suas permissões do Trello permitem as operações solicitadas

Modo de Depuração

Ative o registro de depuração definindo DEBUG=true no seu arquivo .env para obter logs detalhados das operações.

🤝 Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Configuração de Desenvolvimento

  1. Faça um fork do repositório
  2. Crie um branch de funcionalidade
  3. Faça suas alterações
  4. Teste minuciosamente
  5. Envie um pull request

📄 Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

🆘 Suporte

Se você encontrar algum problema:

  1. Consulte a seção de solução de problemas acima
  2. Revise a documentação do MCP
  3. Consulte a documentação do Nango
  4. Abra uma issue neste repositório

🔗 Links Relacionados