ArchForge · MCP

Conectar um agente aos seus projetos

O servidor MCP deixa agentes como Claude Code, Claude Desktop e Cursor lerem e alterarem seus projetos: páginas do Studio, diagramas Mermaid, SDD, Event Storm, ideias, protótipo e a conversa. A chave de API define o que o agente enxerga e se ele pode alterar.

1. Criar a chave

Chave da conta (recomendada): no painel de projetos, clique no ícone de chave ao lado do seu nome. Ela acessa todos os seus projetos, com as permissões que você tem em cada um — em projetos onde você só lê, ela também só lê.

Chave de um projeto: dentro do projeto, ícone de chave no topo. Acessa só aquele projeto.

A chave começa com af_live_ e só aparece uma vez. Por padrão é somente leitura; marque Permitir alterações para liberar as ferramentas de escrita. Revogue quando o agente não precisar mais.

2. Endereço

Transporte Streamable HTTP. Envie a chave em Authorization: Bearer.

POST /api/v1/mcp

3. Claude Code

claude mcp add --transport http archforge /api/v1/mcp \
  --header "Authorization: Bearer af_live_SUA_CHAVE"

4. Cursor e outros clientes

Em ~/.cursor/mcp.json (ou na configuração MCP do cliente):

{
  "mcpServers": {
    "archforge": {
      "url": "/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer af_live_SUA_CHAVE"
      }
    }
  }
}

Ferramentas de leitura

Com a chave da conta, toda ferramenta (exceto list_projects) recebe project_id. Com a chave de um projeto, ele é opcional.

FerramentaDevolve
list_projectsSeus projetos: id, nome, tipo (studio ou ideias), workspace, seu papel e se a chave pode alterar
get_projectVisão geral: páginas do Studio, diagramas Mermaid, decisões do projeto, quantidade de ideias e mensagens
get_diagramDiagrama do Studio com ids. page_id opcional; format text (compacto) ou json (campos completos)
get_diagramsDiagramas Mermaid, com índice, nome e código
get_sddSoftware Design Document em Markdown
get_event_stormEventos, comandos, agregados e hotspots
get_ideasIdeias do canvas
get_prototypeProtótipo em JSON
get_chatÚltimas mensagens da conversa (limit até 100)

Ferramentas de escrita

Só para chaves com escrita e projetos em que você é editor ou dono. As alterações aparecem na hora para quem está com o projeto aberto.

FerramentaFazProjeto
apply_diagram_opsAltera o diagrama (nós, conexões, grupos, layout). Página nova é criada se não existir (page_name dá o nome)studio
create_pageCria uma página e devolve o page_idstudio
rename_pageRenomeia uma páginastudio
save_mermaid_diagramCria ou substitui um diagrama Mermaid (por index ou pelo nome)ideias
delete_mermaid_diagramRemove um diagrama Mermaid pelo índiceideias

Alterar o diagrama do Studio

Leia antes com get_diagram (de preferência format: "json") para conhecer os ids. As operações são aplicadas em ordem. Nós sem x/y são posicionados automaticamente por quem estiver com o projeto aberto.

{
  "project_id": "ID_DO_PROJETO",
  "page_id": "p1",
  "ops": [
    { "op": "add_node", "node": { "id": "cache-catalogo", "label": "Cache do catálogo", "shape": "rounded", "kind": "cache", "tech": "Redis 7", "description": "Guarda o catálogo por 60 s; invalidado por evento." } },
    { "op": "add_edge", "edge": { "id": "e-catalogo-cache", "source": "catalogo", "target": "cache-catalogo", "label": "Lê catálogo [RESP]" } },
    { "op": "update_node", "id": "catalogo", "patch": { "label": "Catálogo", "style": { "fill": "#E3F2FD" } } },
    { "op": "set_parent", "ids": ["cache-catalogo"], "parent_id": "plataforma" },
    { "op": "remove", "ids": ["e-antiga"] },
    { "op": "layout", "scope": "all", "direction": "LR" }
  ]
}

Formas: rect, rounded, ellipse, diamond, cylinder, actor, cloud, document, queue, text, note, group, icon, table. Raias de processo: group com kind: "lane". Operações com id inexistente são ignoradas e listadas na resposta.

Diagramas Mermaid

{
  "project_id": "ID_DO_PROJETO",
  "name": "Fluxo de login",
  "code": "sequenceDiagram\n  App->>API: POST /login\n  API-->>App: 200 + token"
}

O código precisa começar pelo tipo do diagrama (flowchart, sequenceDiagram, erDiagram, classDiagram, stateDiagram-v2…). Use index (veja get_diagrams) para substituir um diagrama específico.

Recursos

Com a chave de um projeto, os conteúdos também são recursos MCP: archforge://project · archforge://sdd · archforge://diagrams · archforge://event-storm · archforge://ideas · archforge://prototype · archforge://diagram. Com a chave da conta, use as ferramentas (elas recebem o project_id).

Contrato