How do I get API access?
API and MCP access is available on the Enthusiast and Pro plans (see /en/pricing/ for details), with a 10-day free trial for your first paid subscription. After access is active, sign in to your account and open Settings → Task API Access → Generate API Key. Your Pergunta key is shown once: store it in a secret manager or environment variable, never publish it, and revoke it and generate a replacement if it is exposed.
How do I connect Pergunta to ChatGPT with OAuth?
In any MCP client with OAuth support, add https://mcp.pergunta.me/mcp and start the connection. The client performs dynamic registration, uses PKCE-compatible authorization, and requests the OIDC scopes openid, profile, and email. Confirm Pergunta consent in the authorization window and let the client return to ChatGPT to finish; you do not create a fixed app, client secret, or ChatGPT token. MCP access requires an active Enthusiast or Pro plan (see /en/pricing/). Verify the connection by running a read-only tool. Use this stable section at /en/faq/#developers if the client asks for the guidance again.
How do I connect Pergunta to ChatGPT with an API key?
Activate access on an Enthusiast or Pro plan (see /en/pricing/), generate a Pergunta key at Settings → Task API Access → Generate API Key, and copy it when it is shown. Configure the MCP client with https://mcp.pergunta.me/mcp and one of the supported header forms below; keep the key in an environment variable or secret store, never in a repository, screenshot, or public message. Run a read-only call to verify the connection, and revoke/rotate the key in Settings if it is shared or no longer needed. See /en/faq/#developers for this stable guidance.
MCP with API key
export PERGUNTA_API_KEY='YOUR_PERGUNTA_API_KEY'
curl --fail --show-error --silent \
--header "x-api-key: ${PERGUNTA_API_KEY}" \
"https://mcp.pergunta.me/mcp"
# Supported alternative: --header "Authorization: Bearer ${PERGUNTA_API_KEY}"
What does an API key look like?
It starts with `tm_`. You can keep multiple active keys and revoke them one by one.
How do I authenticate REST requests?
Use your API key as a bearer token.
List inbox tasks
export PERGUNTA_API_KEY='tm_your_api_key'
curl --fail --show-error --silent \
--header "Authorization: Bearer ${PERGUNTA_API_KEY}" \
"https://app.pergunta.me/api/tasks?scope=inbox"
Can I create tasks over the API?
Yes. Use the same auth pattern for write requests.
Create a task
export PERGUNTA_API_KEY='tm_your_api_key'
curl --fail --show-error --silent \
--request POST \
--header "Authorization: Bearer ${PERGUNTA_API_KEY}" \
--header "Content-Type: application/json" \
--data '{"title":"Draft weekly plan","status":"inbox","priority":"normal"}' \
"https://app.pergunta.me/api/tasks"
Can I use Pergunta MCP in Claude Desktop?
Yes. MCP access is available on the Enthusiast and Pro plans (see /en/pricing/ for details), with a 10-day free trial for your first paid subscription. Pergunta MCP uses API-key authentication; pass your key in the Authorization header as a bearer token.
How do I add it in Claude Code?
Add the remote HTTP server and pass your API key in the Authorization header.
Claude Code
export PERGUNTA_API_KEY='tm_your_api_key'
claude mcp add --transport http --scope user pergunta https://mcp.pergunta.me/mcp \
--header "Authorization: Bearer ${PERGUNTA_API_KEY}"
How do I add it in Codex?
Register the remote server and read the bearer token from an environment variable.
Codex
export PERGUNTA_API_KEY='tm_your_api_key'
codex mcp add pergunta \
--url https://mcp.pergunta.me/mcp \
--bearer-token-env-var PERGUNTA_API_KEY
How do I add it in OpenCode?
Set `PERGUNTA_API_KEY` in your environment and place this block in `~/.config/opencode/opencode.json` or your project `opencode.json`.
OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"pergunta": {
"type": "remote",
"url": "https://mcp.pergunta.me/mcp",
"enabled": true,
"oauth": false,
"headers": {
"Authorization": "Bearer {env:PERGUNTA_API_KEY}"
}
}
}
}
How do I verify that my MCP key works?
Call the verify endpoint before wiring a full client.
Verify key
export PERGUNTA_API_KEY='tm_your_api_key'
curl --fail --show-error --silent \
--header "Authorization: Bearer ${PERGUNTA_API_KEY}" \
"https://mcp.pergunta.me/mcp/verify"
What auth style does MCP use?
MCP accepts OAuth bearer tokens. MCP uses an API key as a bearer token. For key access, it accepts both `x-api-key: <api-key>` and `Authorization: Bearer <api-key>`. These are Pergunta credentials, not ChatGPT credentials; keep them only in environment variables or secret stores, do not share them, and revoke/rotate them when needed.