Servidor Trello MCP
Un potente servidor MCP para interactuar con tableros, listas y tarjetas de Trello a través de hosts de IA.
Tabla de contenido
Prerrequisitos
- Python 3.12 o superior, puede ser administrado fácilmente por
uv - Claude para escritorio instalado
- Credenciales de API y cuenta de Trello
- Gestor de paquetes uv instalado
Preinstalación
- Asegúrese de tener instalada la aplicación Claude Desktop
- Asegúrate de que ya hayas iniciado sesión con tu cuenta en Claude.
- Empezar Claude
Instalación
- Configurar las credenciales de la API de Trello:
- Vaya a Administración de aplicaciones de Trello
- Cree una nueva integración en Nuevo encendido o Integración
- Complete su información (puede dejar vacía la URL del conector Iframe) y asegúrese de seleccionar el espacio de trabajo correcto
- Haga clic en el ícono de su aplicación y navegue hasta "Clave API" desde la barra lateral izquierda.
- Copia tu "clave API" y en el lado derecho: "puedes generar manualmente un Token". Haz clic en la palabra token para obtener tu Token de Trello.
- Cambie el nombre del archivo
.env.example en la raíz del proyecto con .env y configure las variables que acaba de obtener:
TRELLO_API_KEY=your_api_key_here
TRELLO_TOKEN=your_token_here
- Instale uv si aún no lo ha hecho:
curl -LsSf https://astral.sh/uv/install.sh | sh
- Clonar este repositorio:
git clone https://github.com/m0xai/trello-mcp-server.git
cd trello-mcp-server
- Instalar dependencias y configurar el servidor para Claude usando uv::
uv run mcp install main.py
- Reiniciar la aplicación Claude Desktop
Modos de servidor
Este servidor MCP puede ejecutarse en dos modos diferentes:
Modo de aplicación Claude
Este modo se integra directamente con la aplicación Claude Desktop:
- Establezca
USE_CLAUDE_APP=true en su archivo .env (este es el valor predeterminado) - Ejecute el servidor con:
uv run mcp install main.py
- Reinicie la aplicación Claude Desktop
Modo de servidor SSE
Este modo se ejecuta como un servidor SSE independiente que se puede utilizar con cualquier cliente compatible con MCP, incluido Cursor:
- Establezca
USE_CLAUDE_APP=false en su archivo .env - Ejecute el servidor con:
- El servidor estará disponible en
http://localhost:8000 de forma predeterminada (o en su puerto configurado)
Modo Docker
También puedes ejecutar el servidor usando Docker Compose:
- Asegúrate de tener instalados Docker y Docker Compose
- Crea tu archivo
.env con tu configuración - Construya e inicie el contenedor:
- El servidor se ejecutará en modo SSE de forma predeterminada
- Para ver los registros:
- Para detener el servidor:
Configuración
El servidor se puede configurar utilizando variables de entorno en el archivo .env :
| Variable | Descripción | Por defecto |
|---|
| CLAVE DE API DE TRELLO | Tu clave API de Trello | Requerido |
| TRELLO_TOKEN | Su token de API de Trello | Requerido |
| NOMBRE_DEL_SERVIDOR_MCP | El nombre del servidor MCP | Servidor Trello MCP |
| MCP_SERVER_HOST | Dirección de host para el modo SSE | 0.0.0.0 |
| PUERTO_SERVIDOR_MCP | Puerto para modo SSE | 8000 |
| USO_CLAUDE_APP | Si se debe utilizar el modo de aplicación Claude | verdadero |
Puede personalizar el servidor editando estos valores en su archivo .env .
Integración de clientes
Uso con Claude Desktop
- Ejecute el servidor en modo de aplicación Claude (
USE_CLAUDE_APP=true ) - Iniciar o reiniciar Claude Desktop
- Claude detectará y se conectará automáticamente a su servidor MCP
Uso con cursor
Para conectar su servidor MCP a Cursor:
- Ejecute el servidor en modo SSE (
USE_CLAUDE_APP=false ) - En Cursor, vaya a Configuración (ícono de engranaje) > IA > Protocolo de contexto del modelo
- Agregue un nuevo servidor con URL
http://localhost:8000 (o su host/puerto configurado) - Seleccione el servidor al utilizar las funciones de IA de Cursor
También puedes agregar esta configuración a tu archivo JSON de configuración del cursor (normalmente en ~/.cursor/mcp.json ):
{
"mcpServers": {
"trello": {
"url": "http://localhost:8000/sse"
}
}
}
Uso con otros clientes MCP
Para otros clientes compatibles con MCP, diríjalos al punto final SSE en http://localhost:8000 .
Ejemplo de cliente mínimo
A continuación se muestra un ejemplo mínimo de Python para conectarse al punto final de SSE:
import asyncio
import httpx
async def connect_to_mcp_server():
url = "http://localhost:8000/sse"
headers = {"Accept": "text/event-stream"}
async with httpx.AsyncClient() as client:
async with client.stream("GET", url, headers=headers) as response:
# Get the session ID from the first SSE message
session_id = None
async for line in response.aiter_lines():
if line.startswith("data:"):
data = line[5:].strip()
if "session_id=" in data and not session_id:
session_id = data.split("session_id=")[1]
# Send a message using the session ID
message_url = f"http://localhost:8000/messages/?session_id={session_id}"
message = {
"role": "user",
"content": {
"type": "text",
"text": "Show me my Trello boards"
}
}
await client.post(message_url, json=message)
if __name__ == "__main__":
asyncio.run(connect_to_mcp_server())
Capacidades
| Operación | Junta | Lista | Tarjeta | Lista de verificación | Elemento de la lista de verificación |
|---|
| Leer | ✅ | ✅ | ✅ | ✅ | ✅ |
| Escribir | ❌ | ✅ | ✅ | ✅ | ✅ |
| Actualizar | ❌ | ✅ | ✅ | ✅ | ✅ |
| Borrar | ❌ | ✅ | ✅ | ✅ | ✅ |
Capacidades detalladas
Operaciones de la Junta
- ✅ Leer todos los tableros
- ✅ Leer detalles específicos del tablero
Operaciones de lista
- ✅ Leer todas las listas en un tablero
- ✅ Leer detalles específicos de la lista
- ✅ Crear nuevas listas
- ✅ Actualizar el nombre de la lista
- ✅ Archivar (eliminar) listas
Operaciones con tarjeta
- ✅ Leer todas las tarjetas de una lista
- ✅ Leer los detalles específicos de la tarjeta
- ✅ Crea nuevas tarjetas
- ✅ Actualizar los atributos de la tarjeta
- ✅ Eliminar tarjetas
Operaciones de lista de verificación
- ✅ Obtenga una lista de verificación específica
- ✅ Enumere todas las listas de verificación en una tarjeta
- ✅ Crea una nueva lista de verificación
- ✅ Actualizar una lista de verificación
- ✅ Eliminar una lista de verificación
- ✅ Agregar elemento de verificación a la lista de verificación
- ✅ Actualizar el elemento de verificación
- ✅ Eliminar elemento de verificación
Uso
Una vez instalado, puedes interactuar con tus tableros de Trello a través de Claude. Aquí tienes algunos ejemplos de consultas:
- "Muéstrame todas mis tablas"
- "¿Qué listas hay en el tablero [board_name]?"
- "Crear una nueva tarjeta en la lista [nombre_de_lista] con el título [título]"
- "Actualizar la descripción de la tarjeta [card_name]"
- Archivar la lista [nombre_de_lista]
Aquí están mis ejemplos de uso:
Solución de problemas
Si encuentra problemas:
- Verifique sus credenciales de API de Trello en el archivo
.env - Comprueba que tienes los permisos adecuados en tu espacio de trabajo de Trello
- Asegúrese de que Claude for Desktop esté ejecutando la última versión
- Verifique los registros en busca de mensajes de error con el comando
uv run mcp dev main.py - Asegúrese de que uv esté correctamente instalado y en su PATH
Contribuyendo
¡No dudes en enviarnos problemas y solicitudes de mejora!