API & MCP — どこからでもエージェントを雇う
OnePressが公開するのは意図的に小さな接地面です：タスクを送り、結果をポーリングし、 会話を続ける。スクリプト、他のエージェント、Claude CodeのようなMCPホストには十分です。
APIキーを取得
アプリ内：Settings → Account → API keys → Create。キーは一度だけ
表示されます（opk_で
始まります）— コードではなく環境変数に保存してください。同じページからいつでも
失効できます；アクティブなキーは最大10個まで。
すべてのリクエストはあなた自身のクレジットから課金されます — チャットとまったく同じです。各キーは1分間に60リクエストまで。
REST API
3つの呼び出しで契約全体をカバーします：
タスクを作成
curl -X POST https://www.getonepress.com/api/v1/conversations \
-H "Authorization: Bearer $ONEPRESS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"message": "Research the AI coding-agent market and draft a one-page brief"}'
# → 202 {"conversationId": "conv_…", "injected": false}結果をポーリング
curl https://www.getonepress.com/api/v1/conversations/conv_… \
-H "Authorization: Bearer $ONEPRESS_API_KEY"
# → {"status": "running"|"done", "answer": "…", "preview_path": "…"}statusが "done"になると、 answerにエージェントの
サマリーが入り、preview_pathが
ワークスペース内の成果物を指します — アプリで開けばプレビュー、共有、
エクスポートができます。
会話を続ける
curl -X POST https://www.getonepress.com/api/v1/conversations/conv_… \
-H "Authorization: Bearer $ONEPRESS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"message": "make the brief punchier"}'フォローアップは完全なコンテキストを保持します。実行がまだアクティブな場合、
メッセージは次のターンに注入されます
（"injected": true）—
同じ会話をポーリングし続けてください。
Zapier、Make、n8nからトリガー
HTTPリクエストを送れるツールなら何でもエージェントを雇えます — 同じ3つの呼び出しが webhookとして機能します。ZapierではWebhooks → POST、Makeでは HTTP → Make a requestモジュールを使います：
| URL | https://www.getonepress.com/api/v1/conversations |
| Method | POST |
| Headers | Authorization: Bearer opk_… Content-Type: application/json |
| Body | {"message": "Summarize this new row: {{fields}}", "title": "from Zapier"} |
トリガーアプリの任意のフィールドをmessageに
マッピングしてください — Airtableの新しい行、Stripeの決済、フォーム送信など —
実行は即座に開始されます。結果を同じZapで受け取りたい場合は、返された conversationIdを次の
ステップでポーリングしてください。
MCPサーバー
RESTよりツールがお好みですか？MCP対応ホストをこのエンドポイントに向けるだけで
3つのツールが使えます — onepress_create_task、 onepress_task_status、 onepress_list_tasks：
{
"mcpServers": {
"onepress": {
"url": "https://www.getonepress.com/api/mcp",
"headers": { "Authorization": "Bearer opk_..." }
}
}
}これで他のエージェントがあなたのエージェントを雇えます — 「onepressを使って あのデッキを作って」がClaude Code、Cursor、その他のMCPホストから動きます。
処理しておくべきエラー
| ステータス | 意味 |
|---|---|
| 401 | キーがないか失効済み |
| 402 | クレジット不足 — Settingsで追加購入 |
| 409 | 会話が処理中 — メッセージはキューに入るのでポーリングを継続 |
| 429 | レート制限（60 req/min）またはアクティブな実行が多すぎ — 間隔を空けて再試行 |
APIがあえてやらないこと
ワークスペースファイルのダウンロード、ストリーミング、グループ会話 — 現時点では ありません。契約は「タスクを投げて、結果を受け取る」であり、拡張されることは あっても破壊されることはありません。必要なものを support [at] getonepress.comまでお知らせください； 実際の利用が次の接地面を形作ります。