NowPage MCP Server — Admin Guide

Manage the MCP server that lets AI assistants publish to HC Protocol sites.

Architecture

One Vercel deployment, three endpoints:

Endpoint	Protocol	Used By
`/api/mcp`	MCP (Streamable HTTP)	Claude.ai
`/api/publish`	REST (JSON)	ChatGPT, scripts, any HTTP client
`/api/openapi.json`	OpenAPI 3.1 spec	ChatGPT Actions import

Environment Variables

Variable	Required	Description
`NP_API_KEY`	Yes	Default NowPage API key (used when customer provides no Bearer token)
`ALLOWED_DOMAINS`	No	Comma-separated domain allowlist. Empty = no restriction.

Authentication Model

Two modes:

Owner mode: No Bearer token sent. Server uses its own NP_API_KEY. Can publish to any allowed domain.
Customer mode: Customer sends their NowPage API key as Bearer token. Their key is scoped to their domain by NowPage.

Customer Onboarding

Product: $50/month per site

Customer signs up for NowPage — you issue an NP_API_KEY scoped to their domain
Add their domain to ALLOWED_DOMAINS in Vercel env vars
Send them the Customer Connection Guide
They connect Claude.ai or ChatGPT with their API key
They publish by talking to AI

Domain Restrictions

Two layers:

Server-level: ALLOWED_DOMAINS env var blocks all publishing to unlisted domains
Key-level: Each NowPage API key is scoped to specific domains by the NowPage platform

Connecting Claude.ai (Owner)

Go to Claude.ai → Settings → Connectors
Click Add custom connector
URL: https://YOUR-VERCEL-URL/api/mcp
No auth needed

Connecting ChatGPT (Owner)

Go to ChatGPT → Create a GPT → Configure → Actions
Click Import from URL
Paste: https://YOUR-VERCEL-URL/api/openapi.json
Set Authentication: API Key, Bearer, paste your NP_API_KEY

Monitoring

Use Vercel dashboard → Function logs to see publish requests, errors, and per-customer usage.

See also: Deploy Guide | Customer Guide