linkedin-mcp

Claude Code から自分の LinkedIn プロフィールを編集するための MCP サーバーです。厳格な propose-then-approve（提案→承認）の分割を採用しています。モデルは変更をドラフトして diff を表示できますが、書き込みを行えるツールはただ1つだけで、そのツールはあなたが確認した提案にのみ作用します。

パートナー連盟gating: LinkedIn の Profile Edit API は、LinkedIn に承認されたパートナー開発者のみを制限としています（w_compliance は「非公開権限であり、選択された開発者にのみアクセスが付」 — は、docs/api-notes.md 参照）。パートナー承認が完了するまで、apply_proposal は invalid-scope エラーを返します。これは予想道理であり、欠陞ではありません。 それ以外（OAuth、提案、diff）は、現在も動作します。

しくみ

提案は ~/.config/linkedin-mcp/proposals/ に保存されるため、後のセッションで承認を行うこともできます。とう。トークンとクライアント認証情報は ~/.config/linkedin-mcp/.env に権限 600 で保存され、あなた自身が入力するもので、エージェントが入力することはなく、コミットされることもありません（を見 .env.example を参照）。

Related MCP server: kaushik-linkedin-mcp

インストール

Python ≥ 3.11 が必要です。

{
  "mcpServers": {
    "linkedin": {
      "command": "bash",
      "args": ["/path/to/linkedin-mcp/run.sh"]
    }
  }
}

run.sh は初回起動時に .venv/ を作成し、固定化された依存関係をインストールします（stamp-gated で、ブートストラップ出力はすべて stderr に送られ、MCP stdio チャネルをクリーンに保ちます）。

セットアップ

docs/SETUP-KYLE.md に従ってください。LinkedIn Developer アプリの作成、リダイレクト URL の登録、~/.config/linkedin-mcp/.env の入力、auth_start の実行、パートナープログラムへの申請までを説明しています。

開発

bash run.sh --help                                # bootstraps the venv (runtime deps only)
.venv/bin/pip install -r requirements-dev.txt     # adds pytest + coverage tooling
.venv/bin/python -m pytest                        # offline — every test runs against a mock transport

テストスイートには、granted-write fixture（書き込み許可フィクスチャ） が含まれています。これは、ドキュメント化されたすべての書き込みエンドポイントが 200 を返すモックの LinkedIn です。テストは、書き込みが成功する場合でも propose_edit が記録されたログに GET 以外のリクエストをゼロしか残さないこと、また（ポジティブコントロールとして）同じフィクスチャで apply_proposal がドキュメント化された書き込み呼び出しを記録することを検証します。--live-probe は診断用フラグであり、実際のリクエストを 1 回だけ送信して「エンドポイントは正しいがスコープが付与されていない」ことと「エンドポイントが正しくない」ことを区別します。これはテストや CI では実行されず、LINKEDIN_MCP_LIVE_PROBE=1 が必要です。

API サーフェスは、docs/api-notes.md にある日付付きの公式ドキュメントからの原文引用に固定されています。

ライセンス

MIT — LICENSE を参照してください。