3 つのつなぎ方
同じ操作を、どれからでも使えます。API キーは 1 本で足ります。
REST API
名刺・連絡先・交換・名刺ページを HTTP で扱えます。定義は OpenAPI 形式で公開しています。
/openapi.json を開くMCP
MCP に対応した AI から、同じ操作を tool として呼べます。書き込みの tool は、confirm: true を付けないと実行されません。
つなぎ方を見るCLI (meishi)
ターミナルから、連絡先・交換・名刺ページ・AI アバターを操作できます。Node.js 20 以上で動きます。
例を見る
自分の AI から使う
Claude Code や Codex など、MCP に対応した AI から使えます。
API キーを作る
管理画面 (/my) の「鍵を作る」で作ります。キーは作ったときに 1 度だけ表示されます。
MCP をつなぐ
Claude Code なら、ターミナルでこのように実行します。キーは自分のものに置き換えてください。
export MEISHI_API_KEY='<your API key>' claude mcp add --transport http meishi https://kizunatap.com/mcp --header "Authorization: Bearer $MEISHI_API_KEY"話しかける
たとえば、次のように頼めます。
- 今日、誰と名刺交換した?
- 「Acme」の人を探して
- 田中さんにメモを足して
書き込みは、confirm: true を付けたときだけ実行されます。公式 skill は、AI が先に内容を見せて、あなたの OK を取るように教えます。
公式 skill と plugin
公式 skill (kizunatap)
AI に、どの tool をどんな時に使うか、書き込む前の確認の取り方を教えます。使う前に、サーバーの版を確かめてから手引きを読みます。
plugin (meishi)
Claude Code と Codex 用です。MCP の接続先と skill を、ひとまとめにしています。
skill・plugin・CLI のご案内は、お問い合わせください。MCP と REST API は、API キーだけで使えます。 お問い合わせ
コマンドから (meishi)
ターミナルで、連絡先や名刺ページを確かめられます。
meishi me
meishi contacts list --q acme
meishi exchanges list --state captured
meishi profile get
キーは環境変数 MEISHI_API_KEY か設定ファイルから読みます。キーは Authorization ヘッダにだけ載り、画面には出しません。--json を付けると、生の JSON が出ます。
対応一覧
| 方法 | 何ができるか | 必要なもの |
|---|---|---|
| REST API | 名刺・連絡先・交換・名刺ページ・AI アバターの操作を、HTTP で。定義は /openapi.json | API キー |
| MCP (/mcp) | MCP に対応した AI から、同じ操作を tool として呼ぶ。書き込みは confirm: true 付き | API キーと、MCP に対応した AI |
| CLI (meishi) | ターミナルから、連絡先・交換・名刺ページ・AI アバターを操作 | API キーと、Node.js 20 以上 |
| 公式 skill | AI に、tool の使い分けと、書き込み前の確認の取り方を教える | MCP につないだ AI |
| plugin (Claude Code・Codex) | MCP の接続先と skill を、ひとまとめに | Claude Code か Codex |
安全に使うために
- API キーは管理画面 (/my) で作ります。作ったときに 1 度だけ表示されます。
- キーには scope (できる操作の範囲) が付きます。足りない scope の操作は断られます。
- MCP の書き込みは、confirm: true を付けないと実行されません。
- キーはいつでも作り直せます。新しく作ると、前のキーは使えなくなります。
よくある質問
無料で使えますか
使えます。Free では API キーを 1 本作れます。複数のキーを使い分けたいときは Pro です。
どんな AI からつなげますか
いま使えるのは、Claude Code や Codex など、MCP や REST API に対応した AI やツールです。
何ができますか
連絡先の検索・メモ・状態の更新、交換の確認、名刺ページの組み立てと公開、AI アバターの返事などです。書き込みを含む操作は、confirm: true を付けたときだけ実行されます。
API キーはどこで作りますか
管理画面 (/my) の「鍵を作る」から作ります。キーは作ったときに 1 度だけ表示されます。新しく作ると、前のキーは使えなくなります。
AI に連絡先を見せて大丈夫ですか
キーを設定した AI は、そのキーで許された範囲の連絡先を読み書きできます。どの AI にキーを渡すかは、あなたが決めます。心配になったら、キーを作り直せば前のキーは止まります。
skill・plugin・CLI はどこで手に入りますか
お問い合わせください (contact@kazuyahibara.com)。MCP と REST API は、API キーだけで使えます。
自分の名刺をつくる
登録はメールアドレスだけ。名刺ページができたら、API キーを作れます。
