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: beakr
┌──────────────────────────────────────────────────────────┐
│ 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.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
One MCP endpoint for Claude, GPT & Gemini: 100+ tools + no-code connectors + agent workers.
Connect Claude.ai, ChatGPT and MCP-compatible coding clients to aictrl engineering workflows. Check account readiness, find and run tasks, inspect workflow progress and approvals, review pull-request findings, and query repository context. Uses OAuth and your aictrl organisation's permissions.
