Model Context Protocol (MCP) 기반의 독립형 서버로, 개발 에이전트를 작업 관리 시스템에 통합합니다.
Node.js 22.5 이상;
작업 관리 서버에 대한 접근;
유효한 자격 증명 또는 인증 토큰.
Related MCP server: Project Manager MCP
npm install
npm run build어시스턴트는 서버 URL과 인증을 로컬에서 구성합니다. URL은 GESTAO_TAREFAS_API_URL 환경 변수, --api-url 인수 또는 어시스턴트 실행 중에 제공될 수 있습니다.
npm run setupURL이 구성되지 않은 경우 어시스턴트가 다음을 요청합니다:
URL do Gestão de Tarefas:또한 인수를 통해 접근 데이터를 입력할 수 있습니다:
npm run setup -- \
--api-url=https://seu-servidor-de-gestao.exemplo \
--email=seu.email@empresa.gov.br \
--password=suasenha기존 웹 세션 또는 토큰을 사용하려면:
npm run setup -- --api-url=https://seu-servidor-de-gestao.exemplo --token=SEU_TOKEN어시스턴트는 JSON 엔드포인트를 통해 인증을 시도하고, 사용할 수 없는 경우 CSRF를 사용하는 웹 양식을 사용합니다. 자격 증명은 버전 관리되지 않습니다. 세션 또는 토큰은 로컬 .env 파일과 ~/.gestao-tarefas-mcp/config.json에 저장됩니다.
기존 웹 세션 또는 토큰은 어시스턴트에 제공하거나 GESTAO_TAREFAS_API_TOKEN에 설정할 수 있습니다.
.env.example 파일에는 참조 구성이 포함되어 있습니다:
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_토큰, 비밀번호 또는 쿠키를 버전 관리되는 파일에 넣지 마십시오.
서버는 다음을 위한 도구를 제공합니다:
현재 프로젝트와 시스템과의 연결 감지;
프로젝트, 요구사항 및 스프린트 목록 조희;
요구사항 및 하위 작업 생성;
하위 작업 업데이트 및 요구사항 세부 정보 조회;
요구사항을 스프린트에 연결;
오프라인 큐로 작업하고 나중에 항목 동기화;
연결 상태 및 인증 상태 확인.
외부로 표시되거나 시청에 속한 프로젝트는 자동으로 무시될 수 있습니다. 이 동작은 IGNORE_PREFEITURA, IGNORED_PROJECT_PATTERNS 및 .gestaotarefas.json 파일에 의해 제어됩니다.
서버는 stdio를 사용하며 빌드에서 실행되어야 합니다:
npm run build
node dist/index.jsMCP 클라이언트 구성 예시:
{
"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"
}
}
}
}코드를 변경한 후 npm run build를 실행하고 MCP 클라이언트를 다시 시작하십시오.
구성 요소 및 흐름에 대한 개요는 ARCHITECTURE.md에 있습니다.
작업 공간에 접근할 수 있는 에이전트는 다음 순서로 서버를 구성할 수 있습니다:
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.에이전트는 기존 구성을 덮어쓰거나 종속성을 설치하기 전에 확인을 요청해야 합니다. 클라이언트 구성을 변경할 권한이 없는 경우 수동 적용을 위한 지침을 제공해야 합니다.
.gestaotarefas.json 파일은 작업 관리 시스템에 통합될 저장소의 루트에 생성되어야 하며, .git 디렉토리와 같은 수준에 있어야 합니다:
meu-projeto/
├── .git/
├── .gestaotarefas.json
├── package.json
└── src/MCP는 현재 디렉토리에서 이 파일을 찾고 상위 폴더로 계속 올라갑니다. 따라서 공통 폴더에 배치된 구성은 여러 저장소에서 공유될 수 있습니다. 대체 이름 .gestao-tarefas.json도 허용됩니다.
저장소를 프로젝트에 연결하려면 해당 식별자로 meu-projeto/.gestaotarefas.json을 생성하십시오:
{
"projeto_id": 1,
"nome": "Gestão de Tarefas",
"departamento": "TI"
}해당 저장소에서만 MCP를 비활성화하려면 동일한 파일을 사용하십시오:
{
"nome": "Projeto externo",
"tipo": "externo",
"ignorado": true,
"motivo": "Projeto fora do escopo"
}npm test테스트 스위트는 인증, 컨텍스트 감지, 무시된 프로젝트 우회, HTTP 통신, 오프라인 큐, 동기화 및 MCP 도구를 다룹니다.
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Task manager your agent can fully operate: boards, tasks, sprints, roles, worklogs, day planner.
Manage projects, tasks, time tracking, and team collaboration through natural language.
Project management MCP for AI agents with safe task reads and writes.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/bcosta19/mcp-gestao-tarefas'
If you have feedback or need assistance with the MCP directory API, please join our Discord server