クイックスタート

このガイドでは、MCPクライアントとShanoneをエンドツーエンドでつなぎます。APIキーの取得 → クライアントの設定 → 最初のOAuth接続 → 最初のツール呼び出し、という流れです。

前提条件

app.shanone.aiのShanoneアカウント
Cursor、Claude Code、またはstdioサーバーやカスタムヘッダー付きのリモートStreamable HTTPサーバーに対応するその他のMCPクライアントのいずれか
ローカルのstdioプロキシ(下記の推奨手順)を使う場合はNode.js 18以上

ステップ1: APIキーを取得する

API Keysを開く

Shanoneにサインインし、Settings → API Keysに移動します。

キーを作成する

Create API Keyをクリックし、わかりやすい名前(例: 「Cursor — laptop」)を付け、有効期限を選んで確定します。初期値は30日です。7日・60日・90日・カスタム（1〜366日）・無期限も選べます。詳細は有効期限を参照してください。

今すぐコピーする

平文のキーはsh_xxxxxxxxxxxxxxxxという形式で一度だけ表示されます。安全な場所に保管してください——それ以降Shanoneが保持するのはハッシュ値のみです。

APIキーはパスワードと同様に扱ってください。これを持つ人は、あなたのアカウントが実行権限を持つすべてのツールを呼び出せます。バージョン管理にコミットしないでください。

ステップ2: MCPクライアントにShanoneを追加する

最も簡単な接続方法は、ローカルのstdioプロキシ@duzzle/shanone-mcpを使うことです。これは自分のマシン上で動作し、MCPツール呼び出しをAPIキーを使ってHTTPS経由でShanoneのAPIに転送します。

Cursor
Claude Code
任意のMCPクライアント(直接HTTP接続)

~/.cursor/mcp.json(またはCursor Settings → MCP)に以下を追加します。

{
  "mcpServers": {
    "shanone": {
      "command": "npx",
      "args": ["-y", "@duzzle/shanone-mcp"],
      "env": {
        "SHANONE_API_KEY": "sh_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Cursorを再起動する(またはMCPサーバー一覧をリロードする)と反映されます。

claude mcp add shanone \
  --env SHANONE_API_KEY=sh_xxxxxxxxxxxxxxxx \
  -- npx -y @duzzle/shanone-mcp

またはプロジェクトの.mcp.jsonに追加します。

{
  "mcpServers": {
    "shanone": {
      "command": "npx",
      "args": ["-y", "@duzzle/shanone-mcp"],
      "env": {
        "SHANONE_API_KEY": "sh_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

お使いのクライアントがリモートStreamable HTTP MCPに対応し、カスタムヘッダーを送信できる場合は、ローカルプロキシを完全に省略して、Shanoneのホスト型エンドポイントに直接接続できます。

{
  "mcpServers": {
    "shanone": {
      "url": "https://app.shanone.ai/mcp",
      "headers": {
        "Authorization": "Bearer sh_xxxxxxxxxxxxxxxx",
        "X-Org-Id": "org_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

この直接エンドポイントを使うにはAPIキーと組織ID(API Keysページにも表示されています)の両方が必要です——この複合チェックにより、APIキーが1つ漏洩しただけではツールを呼び出せない仕組みになっています。ローカルプロキシとの詳しい比較はMCPセットアップを参照してください。

ステップ3: 最初のインテグレーションを接続する

Shanoneでは、すべてのサービスを事前にまとめて認可しておく必要はありません——OAuthが必要なツールは、エージェントが最初にそのツールを使おうとしたタイミングで単純にconnect_linkを返します。

エージェントにサービスが必要な作業を依頼する

例えば、Cursorのチャットで:「Slackの#generalチャンネルに’hello from Shanone’と投稿して」。

接続リンクをたどる

Slackがまだ接続されていない場合、ツール呼び出しはconnect_linkとともにAuthentication Requiredのようなメッセージを返します。それをブラウザで開き、OAuthフローを完了させます。

同じリクエストを再試行する

エージェントに再試行してもらいます。今回はそのサービス・ユーザーに対する有効なOAuthトークンがShanoneに保存されているため、呼び出しは成功します。

エージェントが認証の壁にぶつかるのを待たずに、ShanoneダッシュボードのIntegrationsから事前にインテグレーションを接続することもできます。

ステップ4: 最初のツール呼び出しを実行する

いくつか自然なプロンプトを試して、エージェントがメタツールのワークフローをたどっていく様子を見てみましょう。

"What Shanone tools are available for GitHub?"
"Search Shanone for tools related to creating a Notion page"
"Create a GitHub issue titled 'Fix login redirect bug' in my-org/my-repo"

裏側では、エージェントはshanone_search_tools(全件を確認したい場合はshanone_list_service_tools)を呼び出し、続いて自分で組み立てた引数でshanone_execute_toolを呼び出しています——あなたが手でJSONを用意する必要はありません。

次のステップ

MCP概要

メタツールのワークフロー全体、Skill Vendor、Permission Vendorのツールを理解する

ベストプラクティス

エージェントへの指示の出し方を工夫して、より良い結果を得る

インテグレーション

Slack、GitHub、Notion、Stripeなどで利用できるものを見る

Skillを保存する

今行ったワークフローを再利用可能なSkillにする

はじめに

Shanoneの使い方

製品ガイド

リリースノート

前提条件

ステップ1: APIキーを取得する

ステップ2: MCPクライアントにShanoneを追加する

ステップ3: 最初のインテグレーションを接続する

ステップ4: 最初のツール呼び出しを実行する

次のステップ

MCP概要

ベストプラクティス

インテグレーション

Skillを保存する

​前提条件

​ステップ1: APIキーを取得する

​ステップ2: MCPクライアントにShanoneを追加する

​ステップ3: 最初のインテグレーションを接続する

​ステップ4: 最初のツール呼び出しを実行する

​次のステップ

MCP概要

ベストプラクティス

インテグレーション

Skillを保存する

前提条件

ステップ1: APIキーを取得する

ステップ2: MCPクライアントにShanoneを追加する

ステップ3: 最初のインテグレーションを接続する

ステップ4: 最初のツール呼び出しを実行する

次のステップ