PromRFC espone un MCP server che permette ai tool AI (Kiro, Claude Desktop, Cursor, etc.) di interagire con le RFC: creare assessment, commentare, richiedere review, segnalare problemi.

Prerequisiti: Python 3.10+, accesso Okta con il gruppo grpCLO assegnato all'app PromRFC.

Architettura

L'endpoint MCP vive sulla stessa Lambda AWS della webapp, su POST /api/mcp. Protocollo MCP JSON-RPC 2.0 con autenticazione Okta JWT.

I client MCP usano il trasporto stdio, quindi serve un piccolo proxy locale che converte stdio in HTTP e gestisce il login Okta.

Installazione

1

Scarica il proxy

Scarica promrfc_proxy.py e salvalo in una posizione stabile:

mkdir -p ~/.local/share/promrfc
curl -sL https://promrfc.prometeiasaas.it/promrfc_proxy.py \
  -o ~/.local/share/promrfc/promrfc_proxy.py

Un singolo file Python, zero dipendenze esterne.

2

Login Okta (una tantum)

Si apre il browser per l'autenticazione:

python3 ~/.local/share/promrfc/promrfc_proxy.py --login

Il token dura 1 ora e viene rinnovato automaticamente.

3

Configura il client MCP

Aggiungi al tuo mcp.json (Kiro: .kiro/settings/mcp.json):

{
  "mcpServers": {
    "promrfc": {
      "command": "python3",
      "args": ["/Users/TUONOME/.local/share/promrfc/promrfc_proxy.py"],
      "env": {
        "PROMRFC_MCP_URL": "https://promrfc.prometeiasaas.it/api/mcp"
      },
      "autoApprove": ["list_rfcs", "get_rfc", "list_comments"]
    }
  }
}
Nota: Sostituisci TUONOME con il tuo username (es. /Users/fioreg su macOS).
4

Verifica

Nel tuo tool AI, prova:

"Elenca le RFC su PromRFC"

Tool disponibili

list_rfcs
Lista RFC con id, codice, titolo, stato, score
get_rfc
Dettaglio completo di una RFC
create_rfc
Crea una nuova RFC come Draft
edit_rfc
Modifica titolo e/o descrizione
delete_rfc
Elimina una RFC (admin o autore)
list_comments
Lista commenti con filtro per stato
post_comment
Posta un commento
resolve_comment
Risolvi un commento
reopen_comment
Riapri un commento
request_review
Richiedi un re-assessment
report_issue
Segnala un problema

Troubleshooting

Token scaduto

Se ricevi errori 401:

python3 ~/.local/share/promrfc/promrfc_proxy.py --login

Porta 18923 occupata

lsof -ti:18923 | xargs kill -9
Nota: Il proxy usa solo la libreria standard Python. Non serve pip install.

PromRFC · C&P — Cloud & Platforms · Prometeia