mcpField
C
connect-tool

connect-tool

github.com/melvynxその他2137 回インストール3 日前に更新
リポジトリ

connect-tool について

connect-toolは、ベンダーのCLIまたはAPIを利用した専用CLIを通じて、エージェントをツールに接続するスキルです。導入、認証、動作確認を案内し、任意のフォルダーから使えるCLIスキルを作成します。

主な機能

  1. 01ベンダー公式CLIの調査と確認
  2. 02確認済みAPIエンドポイントからのCLI作成
  3. 03認証と安全なキー管理の案内
  4. 04読み取り専用操作と実データ取得での検証
  5. 05再利用可能なCLIスキルの作成

活用シーン

  1. 01エージェントをベンダー公式CLIに接続
  2. 02公式CLIがない場合のツール接続
  3. 03一般的なアカウント操作向けコマンドの作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/melvynx/ai-maxxing-skills --skill connect-tool

インストール後、Claude Code で/connect-toolを入力して読み込まれたか確認します。

同梱ファイルscripts/cli_template.py

詳細

ユーザーのエージェントがどのフォルダーからでも使える、新しいツールを <tool>-cli スキルとして追加します。専門用語は避け、ユーザーの言語で、一度に短い質問を1つだけします。

ローカルフォルダーではなくリンクからこのスキルを入手した場合は、リポジトリからほかのものをインストールしないでください。手順で必要になったときだけ、リンク先のファイルを curl -fsSL https://raw.githubusercontent.com/Melvynx/ai-maxxing-skills/main/skills/connect-tool/<path> -o <scratch>/<file> でダウンロードします（例：scripts/cli_template.py）。このスキルで指定されている別のスキルは、その手順に進んだときに https://raw.githubusercontent.com/Melvynx/ai-maxxing-skills/main/skills/<skill-name>/SKILL.md から読みます。

  1. ツールを確認します（タイプミスは修正します。「mtoin」は Notion です）。~/.agents/skills/<tool>-cli/ が存在する場合は、その内容を読み、変更する前にユーザーに確認します。
  2. ベンダー自身が公開している CLI（公式ドキュメント、ドメイン、GitHub 組織を確認）を探し、インストール済みかどうか command -v で確認します。公式 CLI が見つかった場合は手順 3a に進みます。見つからない場合は手順 3b に進みます。ユーザーの許可なく、サードパーティ製パッケージをインストールしてはいけません。 3a. ドキュメントに記載された方法でインストールします。macOS では brew を優先し、次にベンダーの npm i -g／pipx／uv tool install、その次にベンダー独自のインストールスクリプトを使います。sudo が必要な場合は、先にユーザーに確認します。<cli> --version を確認します。見つからない場合はシェルの PATH を修正し、そのことを1行で伝えます。CLI にブラウザーログイン機能がある場合は、それを使ってログインします。キーが必要な場合は、ユーザー自身で export <VAR>=... を ~/.zshrc に追加してもらいます。<cli> --help と、主要なサブコマンドの --help を読みます。 3b. 公式 API ドキュメントを読みます。ベース URL、認証ヘッダー、サブドメインやワークスペース ID などの追加値、ユーザーが実際に使う 5～10 個の操作に対応するエンドポイントを確認します。scripts/cli_template.py を ~/.agents/skills/<tool>-cli/scripts/<tool>.py にコピーし、確認済みのエンドポイントだけを使って定数、auth_headers、SETTINGS、COMMANDS を埋めます（check は低コストの読み取りで、標準ライブラリのみを使用します）。キーを作成する場所と、必要な範囲に絞った権限をユーザーに伝え、ターミナルで python3 ~/.agents/skills/<tool>-cli/scripts/<tool>.py login を実行してもらいます（入力は非表示です）。ユーザーが代わりにチャットへキーを貼り付けた場合は、printf '%s' '<key>' | python3 .../<tool>.py login --<setting> <value> にそのままパイプで渡します。キーを繰り返したり、ほかの場所に書き込んだりしてはいけません。
  3. 動作を確認します。読み取り専用コマンドを1つ実行し、次に実際の読み取りを1つ（項目をいくつか一覧表示）実行します。両方が成功するまで修正します。
  4. 30行未満で ~/.agents/skills/<tool>-cli/SKILL.md を作成します。記載するのは、実際に実行したコマンド、--help で確認したコマンド、またはドキュメントに記載されたコマンドだけにします。<run> は <cli> または python3 ~/.agents/skills/<tool>-cli/scripts/<tool>.py です。
---
name: <tool>-cli
description: <Tool> from the terminal: <main resources>. Use when the user asks to <4-6 real tasks in their words>.
---

Run `<run> <command>`; check `--help` before a command you have not used. Auth: <login command or VAR, where the key comes from>.

- <Task>: `<command> [args]`
- ...

Read before writing. Ask before anything that deletes, publishes, sends, or spends money. Docs: <url>.
  1. Claude Code から使えるようにリンクします。~/.claude/skills がすでに ~/.agents/skills へのリンクでない場合は、mkdir -p ~/.claude/skills && ln -s ~/.agents/skills/<tool>-cli ~/.claude/skills/<tool>-cli を実行します。

最後に3行で、接続したもの（CLI とアカウント）、新しいセッションで /<tool>-cli が表示されること、今すぐ試せることを1つ伝えます。

コメント

Markdown 対応