MCP Trello

Um servidor para interagir com quadros do Trello, lidando com integração de API, limitação de taxa e segurança de tipos.

GitHub

Documentação

MCP Trello

Um servidor Model Context Protocol (MCP) que fornece ferramentas para interagir com quadros do Trello. Este servidor permite integração perfeita com a API do Trello, gerenciando automaticamente limite de requisições, segurança de tipos e tratamento de erros.

Recursos

Integração Completa com Quadros do Trello: Interaja com cartões, listas e atividades do quadro
Limite de Requisições Integrado: Respeita os limites da API do Trello (300 requisições/10s por chave de API, 100 requisições/10s por token)
Implementação com Segurança de Tipos: Escrito em TypeScript com definições de tipos abrangentes
Validação de Entrada: Validação robusta para todas as entradas da API usando esquemas Zod
Tratamento de Erros: Tratamento de erros gracioso com mensagens informativas

Componentes Principais

Servidores MCP: Esses servidores atuam como pontes, expondo APIs, bancos de dados e bibliotecas de código para hosts de IA externos. Ao implementar um servidor MCP em TypeScript, os desenvolvedores podem compartilhar fontes de dados ou lógica computacional de forma padronizada usando JSON-RPC 2.0.
Clientes MCP: São o lado voltado ao consumidor do MCP, comunicando-se com servidores para consultar dados ou executar ações. Os clientes MCP usam SDKs TypeScript, garantindo interações com segurança de tipos e uma abordagem uniforme para o uso de ferramentas.
Hosts MCP: Sistemas como Claude, Cursor, Windsurf, Cline e outras plataformas baseadas em TypeScript coordenam solicitações entre servidores e clientes, garantindo um fluxo de dados contínuo. Um único servidor MCP pode assim ser acessado por múltiplos hosts de IA sem integrações personalizadas.

Ferramentas Disponíveis

MCP Trello fornece as seguintes ferramentas para interagir com o Trello:

Gerenciamento de Quadros

getMyBoards: Recuperar todos os quadros do usuário autenticado (útil para encontrar IDs de quadros)

Gerenciamento de Cartões

getCardsByList: Buscar todos os cartões de uma lista específica
getMyCards: Buscar todos os cartões atribuídos ao usuário atual (funciona sem ID do quadro)
addCard: Adicionar um novo cartão a uma lista especificada
updateCard: Atualizar os detalhes de um cartão existente (nome, descrição, datas de vencimento, etiquetas, posição)
moveCard: Mover um cartão para uma lista ou quadro diferente
archiveCard: Enviar um cartão para o arquivo
changeCardMembers: Adicionar ou remover membros de um cartão

Gerenciamento de Listas

getLists: Recuperar todas as listas do quadro configurado (requer ID do quadro)
addList: Adicionar uma nova lista ao quadro (requer ID do quadro)
archiveList: Enviar uma lista para o arquivo

Informações do Quadro

getRecentActivity: Buscar atividade recente no quadro (requer ID do quadro)

Estrutura do Projeto

mcp-trello/
├── src/
│   ├── index.ts          # Main entry point
│   └── trello/           # Trello API integration
│       ├── client.ts     # Trello client implementation
│       ├── rate-limiter.ts # Rate limiting functionality
│       └── types.ts      # TypeScript type definitions
├── docs/                 # Documentation
├── package.json          # Project configuration
└── tsconfig.json         # TypeScript configuration

Instalação

Usando Smithery

A maneira mais fácil de instalar MCP Trello é usando Smithery:

# For Claude
npx -y @smithery/cli install @Hint-Services/mcp-trello --client claude

# For Cursor
npx -y @smithery/cli install @Hint-Services/mcp-trello --client cursor

# For Windsurf
npx -y @smithery/cli install @Hint-Services/mcp-trello --client windsurf

# For Cline
npx -y @smithery/cli install @Hint-Services/mcp-trello --client cline

# For TypeScript
npx -y @smithery/cli install @Hint-Services/mcp-trello --client typescript

Instalação Manual

pnpm add mcp-trello

Configuração

Adicione o servidor ao seu arquivo de configurações MCP com a seguinte configuração:

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "@Hint-Services/mcp-trello"],
      "env": {
        "trelloApiKey": "your-api-key",
        "trelloToken": "your-token",
        "trelloBoardId": "your-board-id"
      }
    }
  }
}

Variáveis de Ambiente

Obrigatórias

trelloApiKey: Sua chave de API do Trello (obtenha em https://trello.com/app-key)
trelloToken: Seu token do Trello (gere usando sua chave de API)

Opcionais

trelloBoardId: ID completo de 24 caracteres do quadro do Trello com o qual interagir (necessário para operações específicas do quadro)

Encontrando o ID do Seu Quadro

Importante: O ID do quadro NÃO é o código curto que você vê na URL do Trello.

Por exemplo, se a URL do seu quadro for https://trello.com/b/a1b2c3d4/my-board, o código curto a1b2c3d4 não é o ID do quadro.

Para encontrar o ID completo de 24 caracteres do seu quadro:

Configure o servidor apenas com sua chave de API e token (omitindo trelloBoardId inicialmente)
Use a ferramenta getMyBoards para listar todos os seus quadros
Encontre seu quadro nos resultados e copie o campo id (não shortLink)
O ID do quadro terá a seguinte aparência: 507f1f77bcf86cd799439011 (24 caracteres)
Adicione este ID completo à sua configuração como trelloBoardId

Observação: Algumas ferramentas como getMyCards e getMyBoards funcionam sem um ID de quadro configurado. Ferramentas específicas do quadro como getLists, addList e getRecentActivity requerem um ID de quadro válido.

Para Desenvolvedores

Se você tem interesse em contribuir com este projeto ou desenvolver suas próprias ferramentas com este servidor, consulte o Guia de Desenvolvimento.

Saiba Mais

Para mais informações sobre o ecossistema MCP, consulte:

Documentação do Model Context Protocol: Cobertura detalhada da arquitetura MCP, princípios de design e exemplos de uso mais avançados.
Smithery - Registro de Servidores MCP: Diretrizes para publicar suas ferramentas no Smithery e melhores práticas para seu registro.
Documentação do SDK TypeScript do MCP: Documentação abrangente do SDK TypeScript.
Diretrizes de Segurança do MCP: Melhores práticas e recomendações detalhadas de segurança.

Sobre a Hint Services

"O futuro já está aqui, só está distribuído de forma desigual"

William Gibson, Autor

A Hint Services é uma consultoria boutique com a missão de desenvolver e expandir como as interfaces de usuário aproveitam a tecnologia de inteligência artificial. Arquitetamos ambição na interseção entre IA e Experiência do Usuário, fundada e liderada por Ben Hofferber.

Oferecemos workshops especializados de IA para equipes de design que desejam adotar ferramentas de IA sem se tornarem desenvolvedores. Saiba mais sobre nossos treinamentos e workshops.