cli

@noticed/cli

noticed の CLI、stdio 互換ブリッジ、および Claude Code プラグインです。ネットワークを検索し、関係を管理し、HTTP または stdio のみをサポートするクライアントから標準の noticed MCP を利用できます。

npm install -g @noticed/cli
noticed search "AI engineers"
noticed path @sarahml

---

AI コーディングエージェントに追加する

標準の MCP は、レビュー済みの noticed のすべての機能を、直接利用できる型付きツールとして提供します。関係の検索や詳細情報、ミッションや目標、人物ややり取り、リストやビュー、メモリー、スケジュールされた作業などが含まれます。ホスト型サーバーがツールレジストリとスキーマを管理するため、どのクライアントからも常に最新の同じ機能を利用できます。

0.3.x からアップグレードしますか？@noticed/[email protected] 以降で再起動してください。廃止された search ／ execute メタツールは、https://mcp.noticed.so/api/mcp から返される標準の直接ツールに置き換えられています。

接続方法は 2 つあります。ホスト型（インストール不要、Streamable HTTP）または stdio（このパッケージを npx 経由で使用）です。どちらも同じサーバーに接続し、同じ直接ツールを提供します。stdio は、MCP クライアントが Streamable HTTP に対応していない場合にのみ使用してください。

ホスト型 MCP サーバー（推奨 — インストール不要）

https://mcp.noticed.so/api/mcp は、ホスト型の Streamable HTTP エンドポイントです。2 つの認証方法に対応しています。クライアントに合わせて選択してください。

OAuth（claude.ai Web、ChatGPT MCP、OAuth ディスカバリーに対応するクライアント）

ホスト型サーバーは、Dynamic Client Registration に対応した仕様準拠の OAuth 2.1 認可サーバーです。MCP authorization profile に準拠するクライアント（claude.ai のカスタムコネクターや ChatGPT の MCP 統合など）は、サーバーを検出して自身を登録し、ユーザーを同意画面へ自動的に誘導します。クライアント設定に API キーは不要です。

claude.ai のカスタムコネクター：Settings → Connectors → Add custom connector を開き、URL として https://mcp.noticed.so/api/mcp を貼り付けます。あとは claude.ai が処理します。接続済みのアプリケーションは noticed.so/dashboard/oauth-grants で確認（および取り消し）できます。

API キーの Bearer 認証（Claude Code、Cursor、カスタムヘッダーに対応するクライアント）

Authorization: Bearer … ヘッダーを設定できるクライアントでは、noticed.so/dashboard/api-keys でキーを作成し、そのまま使用できます。OAuth フローは不要です。

Claude Code（コマンド 1 つ）：

claude mcp add --transport http --scope user noticed https://mcp.noticed.so/api/mcp --header "Authorization: Bearer nk_live_…"

Cursor、Claude Desktop、Zed、VS Code Copilot、Windsurf、Cline — いずれも URL とヘッダーの設定に対応しています。以下の stdio 用スニペットから command/args/env ブロックを削除し、次の内容に置き換えてください。

{
  "mcpServers": {
    "noticed": {
      "url": "https://mcp.noticed.so/api/mcp",
      "headers": { "Authorization": "Bearer nk_live_…" }
    }
  }
}

Stdio ブリッジ（このパッケージ）

noticed mcp コマンドは、stdio を標準のホスト型 MCP に安全にプロキシします。stdio のインストール方法は、以下からクライアントを選択してください。

Claude Code

claude mcp add --scope project noticed -- npx -y @noticed/cli mcp

--scope project を指定すると、リポジトリのルートに .mcp.json が作成され、チーム全員でサーバーを共有できます。個人スコープにインストールする場合は、このフラグを省略してください。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "noticed": {
      "command": "npx",
      "args": ["-y", "@noticed/cli", "mcp"],
      "env": {
        "NOTICED_API_KEY": "nk_live_…"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）を編集します。

{
  "mcpServers": {
    "noticed": {
      "command": "npx",
      "args": ["-y", "@noticed/cli", "mcp"],
      "env": { "NOTICED_API_KEY": "nk_live_…" }
    }
  }
}

VS Code（Copilot Chat、GitHub Copilot エージェントモード）

ワークスペース用には .vscode/mcp.json を編集するか、グローバル設定の場合は MCP: Open User Configuration を実行します。

{
  "servers": {
    "noticed": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@noticed/cli", "mcp"],
      "env": { "NOTICED_API_KEY": "nk_live_…" }
    }
  }
}

VS Code では mcpServers ではなく servers を使用し、type が必要です。

Windsurf

~/.codeium/windsurf/mcp_config.json を編集します。

{
  "mcpServers": {
    "noticed": {
      "command": "npx",
      "args": ["-y", "@noticed/cli", "mcp"],
      "env": { "NOTICED_API_KEY": "nk_live_…" }
    }
  }
}

Cline (VS Code)

~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json を編集します。

{
  "mcpServers": {
    "noticed": {
      "command": "npx",
      "args": ["-y", "@noticed/cli", "mcp"],
      "env": { "NOTICED_API_KEY": "nk_live_…" }
    }
  }
}

Continue

MCP はエージェントモードでのみ動作します。.continue/mcpServers/noticed.yaml を追加します。

mcpServers:
  - name: noticed
    command: npx
    args: ["-y", "@noticed/cli", "mcp"]
    env:
      NOTICED_API_KEY: nk_live_…

Zed

~/.config/zed/settings.json を編集します（キーは mcpServers ではなく context_servers です）。

{
  "context_servers": {
    "noticed": {
      "command": "npx",
      "args": ["-y", "@noticed/cli", "mcp"],
      "env": { "NOTICED_API_KEY": "nk_live_…" }
    }
  }
}

---

エージェントスキルとプラグイン

移植可能な noticed エージェントスキルは、オープンな skills エコシステムがサポートする Codex、Claude Code、Cursor、その他のクライアントで利用できます。

# Inspect the skill before installation
npx skills add noticedso/cli --list

# Install globally for Codex and Claude Code
npx skills add noticedso/cli --skill noticed-search -g \
  --agent codex --agent claude-code -y

このリポジトリは、Agent Plugins 1.0 パッケージでもあります。移植可能な plugin.json、skills/、mcp.json と、.claude-plugin/ 配下の Claude Code 互換マニフェストが含まれています。MCP 定義は、バージョンが固定された stdio ブリッジを起動します。本番データを照会する前に、クライアント環境で NOTICED_API_KEY を設定するか、noticed config --set-key … を実行してください。

ソースから Claude Code 互換プラグインを直接インストールするには、次のようにします。

git clone https://github.com/noticedso/cli ~/.claude/plugins/noticed
# restart Claude Code

---

クイックスタート（CLI）

# 1. Mint an API key at https://www.noticed.so/dashboard/api-keys
# 2. Configure credentials
noticed config --set-key nk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 3. Search your network
noticed search "react developers"

# 4. Find the shortest path to a specific person
noticed path @sarahml
noticed path --li sarah-chen

# 5. JSON output for scripting
noticed search "frontend" --json | jq '.hits[].github_login'

---

認証

CLI は Bearer API キーで認証します。/dashboard/api-keys でキーを発行してください。シークレットが表示されるのは作成時の一度だけなので、すぐにコピーしてください。トークンは nk_live_… の形式で、キーごとに 1 分あたり 60 リクエストにレート制限されており、同じページから取り消せます。

---

CLI コマンド

noticed search <query>

開発者ネットワークから、人、企業、スキル、トピックを検索します。

noticed search "AI engineers"                  # natural language
noticed search "@sarahml"                      # GitHub username
noticed search "CTO at Vercel"                 # job title + company
noticed search "kubernetes" --source github    # filter by source
noticed search "react" --limit 10 --json       # paginated JSON output
noticed search "engineers" --csv > out.csv     # CSV export
noticed search "Sarah Chen" --paths            # also fetch paths to top hits

フラグ	説明	デフォルト
-l, --limit <n>	結果の最大数	25
-o, --offset <n>	ページネーションのオフセット	0
-s, --source <src>	フィルター：github または linkedin	すべて
--sort <col:dir>	並べ替え：name:asc、company:desc	なし
-p, --paths	上位 5 件への最短経路を取得	オフ
-j, --json	生の JSON を出力	オフ
--csv	CSV として出力	オフ
--no-color	色を無効化	自動

noticed path [target]

自分と人物の間の最短のつながり経路を検索します。

noticed path @sarahml             # by GitHub login
noticed path 12345                # by github_user_id
noticed path --li sarah-chen      # by LinkedIn username
noticed path @sarahml --json      # machine-readable

パスを検索する前に、検索によってログイン名を解決します。検索手順を省略して LinkedIn のユーザー名で直接検索するには、--li を渡します。

noticed config

noticed config                     # show current config
noticed config --set-url <url>     # set API URL
noticed config --set-key <key>     # set API key
noticed config --show              # show current config

設定は ~/.config/noticed/config.json に保存されます（XDG 準拠）。

noticed mcp

noticed mcp                        # bridge stdio to the canonical hosted MCP
noticed mcp --log-level debug      # include proxy debug logging on stderr

noticed completion <shell>

noticed completion bash >> ~/.bashrc
noticed completion zsh >> ~/.zshrc
noticed completion fish > ~/.config/fish/completions/noticed.fish

---

環境変数

変数	説明	必須
NOTICED_API_KEY	https://www.noticed.so/dashboard/api-keys で発行した API キー	はい
NOTICED_MCP_URL	Streamable HTTP MCP エンドポイントを上書きします。デフォルトは https://mcp.noticed.so/api/mcp です	いいえ
NOTICED_API_URL	noticed インスタンスの URL を上書きします。デフォルトは https://www.noticed.so です。セルフホストする場合にのみ設定してください	いいえ
NOTICED_BASE_URL	NOTICED_API_URL のエイリアス	いいえ

優先順位：CLI フラグ > 環境変数 > 設定ファイル。

---

MCP ツール

ホスト型サーバーが、現在の直接ツールの仕様の信頼できる情報源です。クライアントは、標準の tools/list リクエストを通じて、search_people、get_person、network_summary、ミッションや目標の操作、リストとビュー、メモリ、インタラクション、スケジュールなどの一般的なツールを検出します。stdio ブリッジは、別のレジストリを保持せずに、検出と呼び出しを転送します。

MCP Inspector でテストします。

# stdio bridge to the same hosted server
npx @modelcontextprotocol/inspector npx @noticed/cli mcp

# hosted (Streamable HTTP) — set Authorization: Bearer <key> in the inspector UI
npx @modelcontextprotocol/inspector
# URL: https://mcp.noticed.so/api/mcp

または、stdio ブリッジに対して手動でテストします。

echo '{"jsonrpc":"2.0","method":"initialize","id":1,"params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | noticed mcp
echo '{"jsonrpc":"2.0","method":"tools/list","id":2}' | noticed mcp

---

プログラムからの使用

import { NoticedApiClient } from "@noticed/cli";

const client = new NoticedApiClient({
  baseUrl: "https://www.noticed.so",
  apiKey: "nk_live_…",
});

const results = await client.search("AI engineers", { limit: 10 });
const path = await client.path({ to: results.hits[0]?.github_user_id });

console.log(results.hits, path);

---

開発

npm install
npm run build
npm test
npm run lint
npm run check-types

---

noticed のセルフホスト

CLI はデフォルトで、ホスト型 noticed インスタンス https://www.noticed.so を使用します。noticed 自体のセルフホストも可能ですが、運用の負荷が高くなります。ほとんどのユーザーにはホスト型サービスが適しています。

独自のインスタンスを運用する場合は、NOTICED_MCP_URL にその Streamable HTTP MCP エンドポイントを設定してください。標準的なデプロイでは NOTICED_API_URL も使用でき、CLI が /api/mcp を導出します。

export NOTICED_API_URL=https://noticed.your-domain.com
export NOTICED_API_KEY=nk_live_…
noticed search "AI engineers"
noticed mcp

ホスト型サービスのソースは https://github.com/noticedso/noticed にあります。

---

License

MIT © noticed