Model Context Protocol (MCP) に基づくスタンドアロンサーバーで、開発エージェントを Gestão de Tarefas システムに統合します。
Node.js 22.5 以上
Gestão de Tarefas サーバーへのアクセス
有効な認証情報または認証トークン
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既存のWebセッションまたはトークンを使用する場合：
npm run setup -- --api-url=https://seu-servidor-de-gestao.exemplo --token=SEU_TOKENアシスタントはJSONエンドポイントによる認証を試み、利用できない場合はCSRF付きのWebフォームを使用します。認証情報はバージョン管理されません。セッションまたはトークンは、ローカルの .env ファイルと ~/.gestao-tarefas-mcp/config.json に保存されます。
既存のWebセッションまたはトークンは、アシスタントに指定するか、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 ファイルは、Gestão de Tarefas に統合するリポジトリのルート（.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