flikt-mcp
Flikt-AI/flikt-mcp
MCP server for Flikt.AI — browse plan-review results, ask questions, export RFIs, and start reviews from Claude
Instalação
npx convez-ai Flikt-AI/flikt-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
flikt-mcp
MCP server that connects Claude (Claude Code, Claude Desktop, or any MCP client) to your Flikt.AI account: browse plan-review results, dig into coordination conflicts, ask questions, export RFI packages, and — if you allow it — kick off reviews of uploaded plan sets.
Setup
-
Mint a token in the Flikt portal: Settings → API access → Create token. Default tokens are read-only. Check "Allow this token to start reviews" (and set a monthly page limit) only if you want Claude to be able to start reviews against your subscription's page allowance — a token can never charge your card; runs that aren't fully covered by your plan are refused.
-
Copy the token at creation — it is shown exactly once.
-
Add the server (Claude Code):
claude mcp add flikt \ --env FLIKT_API_TOKEN=flk_your_token_here \ -- python -m flikt_mcpor in any MCP client config:
{ "mcpServers": { "flikt": { "command": "python", "args": ["-m", "flikt_mcp"], "env": { "FLIKT_API_TOKEN": "flk_your_token_here" } } } }Install first with
pip install .(from this directory), or run viauvx --from <path-to-flikt-mcp> flikt-mcp.
FLIKT_API_BASE overrides the API host (default https://api.flikt.ai).
Tools
| Tool | Token permission | What it does |
|---|---|---|
list_projects | read | Projects with open-conflict severity rollups + review status |
get_project | read | One project's summary + latest submission id |
list_conflicts | read | Open conflicts (filter by severity / discipline / ball-in-court) |
ask_project | read | Q&A over results: cost exposure, counts, top risks, schedule impact |
check_review_status | read | Poll a running review (uploaded → processing → complete) |
save_rfis_pdf | read | Download the ready-to-send RFI package to a local file |
run_review | start reviews | Start the review for an uploaded, fully-covered submission |
Spend safety
run_review rides your subscription's page allowance and nothing else.
The Flikt API refuses (HTTP 402) any run that would require a payment —
overage, per-project pricing, or spec add-ons — and tells you to finish in
the portal instead. Per-token monthly page limits (set at mint time) bound
what a single token can consume; revoking a token in Settings cuts access
instantly.
Agentic review skill
skills/review-my-plan-set/SKILL.md packages the full loop — check the
plan set, confirm the spend with you, start the review, poll, then deliver
a top-risks summary and the RFI package. Point your Claude skills directory
at it or copy it into .claude/skills/.
Development
pip install -e ".[dev]"
pytest