Koppla ai-workflows /mcp till Claude Code

Pull-modell: Claude Code är klienten som anropar serverns verktyg. En knapp i webb-appen kan inte starta en körning i chatten — det är du som säger "kör workflow X" i Claude Code. "Run in Claude Code"-knappen i appen kopierar bara kommandot åt dig att klistra in.

Ett-klicks setup + verifiering

Klistra in din bearer-token nedan. Klicka sedan "Kopiera hela kedjan" — kommandot sätter env-var, (åter)registrerar MCP-servern med token, listar och hämtar servern, allt i ett svep. Klistra in i en ny Claude Code-terminal, kör, och verifiera med test-workflowet längre ned.

Token stannar i webbläsaren — den skickas ingenstans och sparas inte. Hämta den från Connections.

# 1) Sätt token som env-var (endast denna session)
export AI_WORKFLOWS_MCP_TOKEN='<din-bearer-token>'

# 2) (Åter)registrera MCP-servern
claude mcp remove ai-workflows -s user 2>/dev/null || true
claude mcp add --transport http ai-workflows \
  https://ai-workflows.webbografi.com/mcp \
  --header "Authorization: Bearer $AI_WORKFLOWS_MCP_TOKEN" -s user

# 3) Verifiera
claude mcp list
claude mcp get ai-workflows

Ingen token angiven — kedjan innehåller platshållaren <din-bearer-token>. Fyll i fältet innan du kopierar för att slippa manuella steg.

Kör ett test-workflow (end-to-end verifiering)

Ett-klicks-verifiering: kopiera kommandot nedan och klistra in i en ny Claude Code-session. Använder ett känt lättviktigt workflow (google-ads-audit-checklist) för att bekräfta att MCP- servern svarar och att runnern kan hämta workflow-datan.

kör workflow google-ads-audit-checklist

Förväntat resultat: Claude Code anropar get_workflow mot ai-workflows-MCP:n och listar stegen. Får du 401, kontrollera token. Får du "unknown tool", starta ny session och kör /mcp.

Steg 1 — Lägg till servern

Token ska aldrig skrivas i klartext i en fil. Lägg den i en env-var först:

export AI_WORKFLOWS_MCP_TOKEN="<din-bearer-token>"

Din token hittar du i Connections.

Alternativ A — kommando (enklast, användar-scope)

claude mcp add --transport http ai-workflows \
  https://ai-workflows.webbografi.com/mcp \
  --header "Authorization: Bearer $AI_WORKFLOWS_MCP_TOKEN" -s user

Scope: -s user (alla projekt) · -s project (delas via .mcp.json) · -s local (default, bara detta projekt).

Alternativ B — projekt-.mcp.json (delas via git, token via env-var)

Lägg i repo-roten:

{
  "mcpServers": {
    "ai-workflows": {
      "type": "http",
      "url": "https://ai-workflows.webbografi.com/mcp",
      "headers": { "Authorization": "Bearer ${AI_WORKFLOWS_MCP_TOKEN}" }
    }
  }
}

Claude Code expanderar ${AI_WORKFLOWS_MCP_TOKEN} från miljön — token hamnar aldrig i filen. Stödjer även ${VAR:-default}. Om env-varen saknas vägrar Claude Code att parsa konfigen.

Steg 2 — Verifiera

claude mcp list
claude mcp get ai-workflows

I en ny Claude Code-session, kör /mcp — servern ska stå som connected med ett antal tools. Tillägget slår oftast igenom först i en ny session.

Steg 3 — Kör ett workflow

I chatten, säg t.ex.:

kör workflow google-ads-ngram-analyzer för Chessiverse

Runnern hämtar workflow-definitionen från ai-workflows-servern (get_workflow / list_workflows), och kör stegen via Markifact MCP + native AI/kod-steg. Saknas servern används de lokala kopiorna i ../_data/json/ som fallback.

Kommando-format (för "Run in Claude Code"-knappen)

Felsökning

  • 401 / unauthorized → fel eller utgången token. Uppdatera AI_WORKFLOWS_MCP_TOKEN och kör om claude mcp add (eller starta en ny session om du använder .mcp.json).
  • Servern syns inte i /mcp → starta en ny session; kontrollera claude mcp get ai-workflows.
  • Tools men 0 exponerade → serversidan svarar men listar inga verktyg; kontrollera serverns MCP-implementation.
  • Config parse-fel → env-varen är inte satt i skalet där du startar Claude Code.
Bläddra bland templates