Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Forja MCP Server triage my Jira tasks and flag blockers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Forje seu fluxo de trabalho de engenharia. Companion do Claude Code: agents, skills e scripts orquestrados, expostos via MCP.
Jira · Análise de repositórios · Padrões de commit/PR/DevOps · Relatórios · Slides & infográficos · RAG sobre a base de conhecimento
Forja é uma plataforma modular que reúne vários agents especializados (baseados no Claude Agent SDK), skills reutilizáveis e scripts. Ele foi pensado como uma ferramenta auxiliar ao Claude Code (e similares — Cursor, Claude Desktop): expõe os agents como tools MCP que você aciona de dentro da sua sessão de código. Há também uma interface web (FastAPI + dashboard) como cockpit local opcional e um CLI.
MCP server (principal) — os agents viram tools no Claude Code/Cursor/Claude Desktop. Veja docs/mcp.md.
Dashboard web (cockpit) — executar agents por clique e revisar resultados/artefatos.
CLI — forja run <agent> para automações.
Módulo | Papel |
Jira | Analisar e controlar tasks no Jira (via MCP Atlassian): status, backlog, triagem, resumos. |
Repo Analysis | Varrer e analisar os diversos repositórios de serviços/projetos: saúde, dependências, convenções, débitos. |
Commit / PR / DevOps | Gerar bons padrões de commit (Conventional Commits), descrições de PR e práticas de DevOps/CI. |
Reports | Montar relatórios (status, sprint, incidentes) a partir de dados do Jira, dos repos e do RAG. |
Slides & Infographics | Conectar ao NotebookLM para gerar slides e infográficos a partir dos relatórios/base. |
RAG | Busca semântica sobre a base de documentos e |
Tudo é exposto por um dashboard web e por uma API que orquestra os agents.
Related MCP server: mcp-dev-tools
┌──────────────────────────────────────────────────────────┐
│ Web Dashboard + API (FastAPI) │
└───────────────┬──────────────────────────────────────────┘
│
┌───────▼────────┐ registry + runtime
│ Orchestrator │ ── Claude Agent SDK ──┐
└───────┬────────┘ │
┌────────────┼───────────────┬──────────┬──────┴──────┐
┌──▼──┐ ┌─────▼─────┐ ┌──────▼─────┐ ┌──▼────┐ ┌─────▼─────┐
│Jira │ │Repo Anal. │ │Commit/PR/ │ │Reports│ │Slides/ │
│agent│ │ agent │ │DevOps agent│ │ agent │ │Infographic│
└──┬──┘ └─────┬─────┘ └──────┬─────┘ └──┬────┘ └─────┬─────┘
│ │ │ │ │
┌──▼────────────▼────────────────▼──────────▼─────────────▼──┐
│ Integrations: Jira (MCP) · Git repos · NotebookLM │
│ RAG: embeddings (configurável) + vector store (Chroma) │
└─────────────────────────────────────────────────────────────┘Detalhes em docs/architecture.md.
# 1. Criar e ativar o ambiente
python -m venv .venv
# Windows (PowerShell): .venv\Scripts\Activate.ps1
# Linux/macOS: source .venv/bin/activate
# 2. Instalar em modo editável (dev)
pip install -e ".[dev]"
# 3. Configurar variáveis
cp .env.example .env # e preencha as chaves
# 4. Subir o dashboard
forja serve
# ou: uvicorn forja.web.app:app --reloadScripts de bootstrap prontos em scripts/ (bootstrap.ps1 / bootstrap.sh).
pip install -e ".[mcp]"
forja mcp # sobe o servidor MCP (stdio)Registre no Claude Code (copie .mcp.json.example para .mcp.json) ou:
claude mcp add forja -- ./.venv/Scripts/python.exe -m forja.mcp_serverOs agents ficam disponíveis como tools forja_jira, forja_rag, forja_reports, etc. Detalhes em docs/mcp.md.
main — produção, sempre estável, com tags de release.
develop — integração contínua das features.
feature/* — uma funcionalidade por branch, PR para develop.
release/* — estabilização, bump de versão e CHANGELOG, PR para main + tag.
hotfix/* — correção urgente a partir de main.
Versionamento SemVer, histórico em CHANGELOG.md. Guia completo em docs/gitflow.md e helper em scripts/new_feature.sh.
src/forja/ código da plataforma (orchestrator, agents, rag, integrations, web)
knowledge_base/ documentos .md que alimentam o RAG
docs/ arquitetura, git flow e docs por agent
scripts/ bootstrap e helpers de git flow
tests/ testes (pytest)MIT.
This server cannot be deployed
Your org's AI agents, tasks, runs, search, and brain files as MCP tools and resources.
One MCP endpoint for Claude, GPT & Gemini: 100+ tools + no-code connectors + agent workers.
An agent-first office suite Claude & ChatGPT read and write over one MCP URL.
AgentPMT is the AI agent marketplace that turns any MCP-compatible AI assistant into an autonomous employee. Connect once and your agents gain access to a growing ecosystem of tools, workflows, and skills spanning communication, data analytics, development, file management, search, and more. AgentPMT dynamically discovers and orchestrates tools from across the MCP ecosystem, so your agents can independently find the right tool for any task without manual configuration.
