MCP Gestão de Tarefas

Eigenständiger Server basierend auf dem Model Context Protocol (MCP), um Entwicklungsagenten in das System Gestão de Tarefas zu integrieren.

Anforderungen

• Node.js 22.5 oder höher;

• Zugriff auf den Server von Gestão de Tarefas;

• gültige Anmeldedaten oder ein Authentifizierungstoken.

Related MCP server: Project Manager MCP

Installation

npm install
npm run build

Konfiguration und Authentifizierung

Der Assistent konfiguriert die Server-URL und die Authentifizierung lokal. Die URL kann über die Variable GESTAO_TAREFAS_API_URL, über das Argument --api-url oder während der Ausführung des Assistenten angegeben werden.

npm run setup

Wenn die URL nicht konfiguriert ist, fordert der Assistent sie an:

URL do Gestão de Tarefas:

Die Zugangsdaten können auch über ein Argument angegeben werden:

npm run setup -- \
  --api-url=https://seu-servidor-de-gestao.exemplo \
  --email=seu.email@empresa.gov.br \
  --password=suasenha

Um eine Websitzung oder ein bereits vorhandenes Token zu verwenden:

npm run setup -- --api-url=https://seu-servidor-de-gestao.exemplo --token=SEU_TOKEN

Der Assistent versucht, sich über den JSON-Endpunkt zu authentifizieren; ist dieser nicht verfügbar, verwendet er das Webformular mit CSRF. Die Anmeldedaten werden nicht versioniert. Die Sitzung beziehungsweise das Token wird in der lokalen .env-Datei und in ~/.gestao-tarefas-mcp/config.json gespeichert.

Eine Websitzung oder ein vorhandenes Token kann dem Assistenten mitgeteilt oder in GESTAO_TAREFAS_API_TOKEN konfiguriert werden.

Umgebungsvariablen

Die Datei .env.example enthält die Referenzkonfiguration:

GESTAO_TAREFAS_API_URL=https://seu-servidor-de-gestao.exemplo
GESTAO_TAREFAS_API_TOKEN=cole_a_sessao_web_ou_token_aqui
OFFLINE_QUEUE_PATH=~/.gestao-tarefas-mcp/queue.sqlite
REQUEST_TIMEOUT_MS=5000
IGNORE_PREFEITURA=true
IGNORED_PROJECT_PATTERNS=prefeitura,pmsp,pref-,pm-,pm_

Legen Sie keine Tokens, Passwörter oder Cookies in versionierten Dateien ab.

Funktionen

Der Server stellt Werkzeuge bereit, um:

• das aktuelle Projekt und dessen Verknüpfung mit dem System zu erkennen;

• Projekte, Anforderungen und Sprints aufzulisten;

• Anforderungen und Teilaufgaben zu erstellen;

• Teilaufgaben zu aktualisieren und Anforderungsdetails abzurufen;

• Anforderungen zu Sprints zuzuordnen;

• mit einer Offline-Warteschlange zu arbeiten und die Einträge später zu synchronisieren;

• die Konnektivität und den Authentifizierungsstatus zu überprüfen.

Als extern oder zur Stadtverwaltung gehörend markierte Projekte können automatisch ignoriert werden. Dieses Verhalten wird durch IGNORE_PREFEITURA, IGNORED_PROJECT_PATTERNS und die Datei .gestaotarefas.json gesteuert.

Ausführung

Der Server verwendet stdio und muss aus dem Build heraus ausgeführt werden:

npm run build
node dist/index.js

Beispielkonfiguration für einen MCP-Client:

{
  "mcpServers": {
    "gestao-tarefas": {
      "command": "node",
      "args": ["/caminho/para/mcp-gestao-tarefas/dist/index.js"],
      "env": {
        "GESTAO_TAREFAS_API_URL": "https://seu-servidor-de-gestao.exemplo",
        "GESTAO_TAREFAS_API_TOKEN": "CONFIGURADO_LOCALMENTE",
        "OFFLINE_QUEUE_PATH": "~/.gestao-tarefas-mcp/queue.sqlite",
        "IGNORE_PREFEITURA": "true"
      }
    }
  }
}

Nach Codeänderungen führen Sie npm run build aus und starten den MCP-Client neu.

Eine Übersicht über Komponenten und Abläufe finden Sie in ARCHITECTURE.md.

Konfiguration durch Entwicklungsagenten

Ein Agent mit Zugriff auf den Workspace kann den Server in der folgenden Reihenfolge konfigurieren:

Configure o servidor MCP deste projeto.

1. Leia o README.md e identifique o cliente MCP em uso.
2. Use o diretório atual como diretório do projeto.
3. Instale as dependências apenas se necessário.
4. Execute npm run build.
5. Registre o servidor usando node dist/index.js e preserve as demais
   configurações existentes do cliente.
6. Solicite a URL do servidor e a autenticação caso ainda não estejam
   configuradas. Não exiba nem grave tokens ou senhas no chat.
7. Inicie o servidor ou informe que o cliente precisa ser reiniciado.

Der Agent muss vor dem Überschreiben vorhandener Konfigurationen oder der Installation von Abhängigkeiten um Bestätigung bitten. Wenn er nicht berechtigt ist, die Client-Konfiguration zu ändern, muss er die Anweisungen für die manuelle Anwendung bereitstellen.

Projektkonfiguration

Die Datei .gestaotarefas.json muss im Stammverzeichnis des Repositorys erstellt werden, das in Gestão de Tarefas integriert wird, auf derselben Ebene wie das .git-Verzeichnis:

meu-projeto/
├── .git/
├── .gestaotarefas.json
├── package.json
└── src/

Der MCP sucht diese Datei vom aktuellen Verzeichnis aus und setzt die Suche in den übergeordneten Ordnern fort. Eine in einem gemeinsamen Ordner abgelegte Konfiguration kann so auch von mehreren Repositorys gemeinsam genutzt werden. Der alternative Name .gestao-tarefas.json wird ebenfalls akzeptiert.

Um das Repository mit einem Projekt zu verknüpfen, erstellen Sie meu-projeto/.gestaotarefas.json mit der entsprechenden Kennung:

{
  "projeto_id": 1,
  "nome": "Gestão de Tarefas",
  "departamento": "TI"
}

Um den MCP nur in diesem Repository zu deaktivieren, verwenden Sie dieselbe Datei:

{
  "nome": "Projeto externo",
  "tipo": "externo",
  "ignorado": true,
  "motivo": "Projeto fora do escopo"
}

Tests

npm test

Die Testsuite deckt Authentifizierung, Kontexterkennung, das Umgehen ignorierter Projekte, HTTP-Kommunikation, Offline-Warteschlange, Synchronisierung und MCP-Werkzeuge ab.