---
title: Quickstart
description: Connect AI Workflow MCP to an agent or REST client.
type: guide
summary: Install the MCP endpoint and make the first query.
related:
  - /en/docs/client-setup
  - /en/docs/mcp
  - /en/docs/api-keys
---

# Quickstart



## 1. Create An Account [#1-create-an-account]

Open the production sign-in page:

```txt
https://aiworkflowmcp.com/en/sign-in/
```

Sign in with Google/Gmail or email. After sign-in, open:

```txt
https://aiworkflowmcp.com/en/account/api-keys/
```

Create a key, copy it once, and store it as `AIWORKFLOWMCP_API_KEY`.

## 2. Add The MCP Endpoint [#2-add-the-mcp-endpoint]

Claude Code:

```bash
claude mcp add --transport http aiworkflowmcp https://mcp.aiworkflowmcp.com/mcp
```

HTTP MCP clients:

```json
{
  "mcpServers": {
    "aiworkflowmcp": {
      "url": "https://mcp.aiworkflowmcp.com/mcp",
      "headers": {
        "Authorization": "Bearer ${AIWORKFLOWMCP_API_KEY}"
      }
    }
  }
}
```

Public basic queries can run without a key. Authenticated keys add account-level usage history and quota routing.

## 3. Run A REST Smoke Test [#3-run-a-rest-smoke-test]

```bash
curl -fsS "https://mcp.aiworkflowmcp.com/v1/models/list?limit=1"
curl -fsS "https://api.aiworkflowmcp.com/health"
```

Authenticated REST:

```bash
curl -fsS \
  -H "Authorization: Bearer ${AIWORKFLOWMCP_API_KEY}" \
  "https://mcp.aiworkflowmcp.com/v1/models/list?limit=1"
```

## 4. Call One MCP Tool [#4-call-one-mcp-tool]

```bash
curl -fsS https://mcp.aiworkflowmcp.com/mcp \
  -H "content-type: application/json" \
  -H "Authorization: Bearer ${AIWORKFLOWMCP_API_KEY}" \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_ai_model",
      "arguments": {
        "model_id": "gpt-5"
      }
    }
  }'
```

The response contains chat-ready `content` and typed `structuredContent`.

## 5. Check Production Health [#5-check-production-health]

```bash
curl -fsS https://mcp.aiworkflowmcp.com/health
```

For production automation, treat `status: "ok"` and `data_quality.latest_eval_status: "PASS"` as the green path. Treat stale entities or source errors as a reason to retry later or disable `fresh_only=true` only for non-critical discovery.


---

For a semantic overview of all documentation, see [/en/sitemap.md](/en/sitemap.md)

For an index of all available documentation, see [/en/llms.txt](/en/llms.txt)