接続方法

• アプリでコネクタやリモートMCPサーバーを追加できる場合：URLとログインを使います。ほとんどのアプリが対応しています。
• 「許可」をクリックする人がいない場合（スクリプト、サーバー、定期ジョブなど）：APIキーを使います。
• アプリが自分のマシン上のMCPサーバーしか起動できない場合：CLIのstdioブリッジを実行します。
• エージェントがターミナルで作業し、スキルを使う場合：CLIとAgent Skillをインストールします。

アプリはMCPのStreamable HTTPでSPREVAとやり取りし、OAuthでログインします。コピーしたり管理したりするキーはありません。ワークスペースはSPREVA自身のページで選び、アプリの接続はいつでも解除できます。

https://dev-app.spreva.ai/api/mcp

1. 1

   アプリでコネクタやMCPサーバーを追加する場所にURLを貼り付けます。

2. 2

   アプリがSPREVAを開きます。ログインしてワークスペースを選び、許可をクリックします。

3. 3

   エージェントが自分だけで何をしてよいかは、SPREVAのエージェント連携で決められます。各アプリの接続もそこで解除できます。

人の操作なしで動く自動化や、OAuthでログインできないアプリ向けです。SPREVAの開発者、APIキーの順に開いてキーを作成し、Bearerトークンとして送ります。

Authorization: Bearer spreva_sk_...

ほとんどのアプリはJSON設定でキーを受け付けます。キーはどちらのコネクタでも使えます。

{
  "mcpServers": {
    "spreva": {
      "type": "http",
      "url": "https://dev-app.spreva.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer spreva_sk_..."
      }
    }
  }
}

自分のマシン上のMCPサーバーしかstdioで起動できないアプリもあります。spreva mcpはそのためのサーバーです。ローカルで動き、SPREVA_API_KEYからAPIキーを読み取って、すべての呼び出しをSPREVAに渡します。

{
  "mcpServers": {
    "spreva": {
      "command": "npx",
      "args": [
        "-y",
        "@spreva/cli",
        "mcp"
      ],
      "env": {
        "SPREVA_API_KEY": "spreva_sk_...",
        "SPREVA_URL": "https://dev-app.spreva.ai"
      }
    }
  }
}

Node.js 20以降が必要です。ツール、応答、権限はURLで接続した場合と同じです。

OpenClaw、Hermes Agent、Claude Code、Codexなど、ターミナルで作業するエージェントは、SPREVAをコマンドラインとして使えます。Agent Skillが、いつどのようにSPREVAを使うかをエージェントに伝えます。

1. 1

   CLIをインストールします。

   npm i -g @spreva/cli

2. 2

   APIキーを設定します。

   export SPREVA_API_KEY=spreva_sk_...
   export SPREVA_URL=https://dev-app.spreva.ai

3. 3

   エージェント用のスキルをインストールします。対象はclaude、codex、openclaw、hermes、そしてスキルに対応したその他のエージェント向けのagentsです。

   spreva skill install --target claude

4. 4

   すべて揃っているか確認します。

   spreva doctor

詳しくはCLIとAgent Skillを参照してください。