ドキュメント

クイックスタート

以下の手順はすべて Web コンソールで完結します。アカウントを登録し、「新規プロジェクト」をクリックして 3 ステップに従ってください。API キーは不要です。

1. APIをインポートする

   OpenAPI仕様のURL、curlコマンド、またはPostmanコレクションを用意すると、Invokeraが型付きのMCPツールに変換します。

2. ドメイン所有権を確認する

   DNS TXTレコードまたはwell-knownファイルで、APIのドメインを所有していることを証明します。

3. 公開する

   公開されると、プロジェクトにはMCPエンドポイント、RESTエンドポイント、AIが読み取れるランディングページが用意されます。

成功するとこうなる

実際のプロジェクトの 4 つの場面です。照らし合わせて順調かどうか確認してください。 公開中の完成例を見る：デモプロジェクト Invokera Status。

3つのインポート方法

OpenAPI（URL）

公開されている OpenAPI/Swagger 仕様の URL をコンソールの OpenAPI タブに貼り付けてください。最速かつ最も完全な方法です。

curl

動作するcurlコマンドをコンソールのcurlタブに貼り付けると、Invokeraがそこから型付きツールを導出します。例：

curl https://api.example.com/v1/users -H "Authorization: Bearer KEY"

Postman

PostmanでコレクションをCollection v2.1 JSONとしてエクスポートし、そのJSONをコンソールのPostmanタブに貼り付けます。

ドメイン検証のトラブルシューティング

検証は _invokera-challenge.<あなたのドメイン> の TXT レコード（または /.well-known/invokera-challenge.txt のファイル）を確認します。チャレンジの有効期間は 72 時間、確認は最大 30 回までです。よくある失敗：

MCPで接続する

Claude Code

最も速い接続方法 — ターミナルでコマンドを 1 つ実行するだけです:

claude mcp add --transport http your-project https://invokera.com/r/your-project --header "Authorization: Bearer inv_YOUR_TOKEN"

成功の確認: チャットで何か質問してみてください。ツール名が表示されれば接続成功です。

Claude Desktop

streamable HTTPエンドポイントとエンドポイントトークンを使って、claude_desktop_config.jsonにプロジェクトを追加します：

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "your-project": {
      "type": "http",
      "url": "https://invokera.com/r/your-project",
      "headers": { "Authorization": "Bearer inv_YOUR_TOKEN" }
    }
  }
}

お使いの OS のファイルを編集した後、Claude Desktop を再起動すると変更が反映されます。

成功の確認: チャットで何か質問してみてください。ツール名が表示されれば接続成功です。

Cursor

プロジェクトのルートに同じ JSON 形式で .cursor/mcp.json を作成します:

{
  "mcpServers": {
    "your-project": {
      "type": "http",
      "url": "https://invokera.com/r/your-project",
      "headers": { "Authorization": "Bearer inv_YOUR_TOKEN" }
    }
  }
}

成功の確認: チャットで何か質問してみてください。ツール名が表示されれば接続成功です。

REST

MCPクライアントがない場合でも、各プロジェクトは自己記述的なRESTエンドポイントを提供します：

curl https://invokera.com/v1/your-project/tools -H "Authorization: Bearer inv_YOUR_TOKEN"

自動化 / CI

スクリプトからプロジェクトを管理するためのプラットフォーム API キー（ik_）は、まだセルフサービスでは発行できません。自動化や CI 連携が必要な場合はお問い合わせください。アカウントに対して有効化します。呼び出しは次のようになります:

curl -X POST https://invokera.com/api/v1/projects -H "Authorization: Bearer ik_YOUR_API_KEY" -H "Content-Type: application/json" -d '{"specUrl":"https://api.example.com/openapi.json"}'

FAQ

呼び出しがエラーコードで失敗します——どういう意味ですか？

MCP エラーには JSON-RPC コードと HTTP ステータスが含まれます。頻出のもの：

ドメイン確認が失敗し続けます——何を確認すべきですか？

DNS TXTレコードの伝播には時間がかかることがあります——数分待ってから再度確認してください。確認の対象は登録可能ドメイン（eTLD+1）であり、サブドメインではありません。APIがホスティングプラットフォームのサブドメイン上にある場合は、代わりに .well-known ファイル方式を使ってください。

inv_ トークンと ik_ トークンの違いは何ですか？

inv_ エンドポイントトークンは、公開済みツールの呼び出しだけを許可します。ik_ プラットフォームAPIキーはアカウントとプロジェクトを管理するためのものです——決してエージェントに渡さないでください。

エンドポイントトークンをローテーションするには？

コンソールでプロジェクトを開き、「トークンをローテーション」を使用します。古いトークンは即座に無効になるため、直後にエージェントの設定を更新してください。

呼び出しトークンを控え忘れました——再取得できますか？

トークンが再表示されることはありません。プロジェクトページの「トークンをローテーション」を使うと即座に新しいトークンが発行され、古いものは無効になります。使用していたすべてのクライアントを更新してください。

Claude は接続できているのにツールが見えません——なぜ？

多くは次の 3 つのいずれかです：プロジェクトに有効化されたツールがない（コンソールで有効化）；設定変更後にクライアントを完全に再起動していない（Claude Desktop は完全終了して再起動が必要）；エンドポイント URL やトークンの写し間違い——まずコンソールのテスト実行でサーバー側の問題を切り分けてください。