メインコンテンツへスキップ
見出し画像

【初心者版手順付き】noteの記事自動公開をCodex+MCPでやってみたが失敗した話

    本記事は実装してみたものの、途中で失敗に気づいたため、作業を完了できておりません。
    失敗を含めて実装ができるようになった方法は以下の記事にまとめ直しておりますので、そちらをご覧ください。

    【超初級・コピペで使える】noteの記事自動投稿の爆速導入法とつまづきポイントをやさしく解説
    https://note.com/egashi_aiwork/n/ne22ac1e11cb1

    noteの記事を、毎回ブラウザへコピーして投稿する作業をなくしたい。

    記事本文を作る。
    タイトルを入力する。
    タグを付ける。
    見出しや太字を整える。
    下書きとして保存する。

    1記事だけなら、それほど大きな作業には見えません。

    ただ、記事を継続して投稿していると、毎回同じ操作をする時間が積み重なります。

    そこで今回は、以前noteの記事で見つけたMCPを使い、Markdownで書いた記事をCodexからnoteへ投稿できる環境づくりに挑戦しました。

    参考にさせていただいたリポジトリはこちらです。

    https://github.com/Go-555/note-post-mcp

    この記事では、WindowsとCodexを使い、Markdown形式の記事をnoteへ下書き保存、または公開する環境を作っていきます。

    ただし、この記事はまだ執筆途中です。

    現時点では、MCPをCodexへ登録し、下書き保存を実行するところまで進みました。

    完成した際は成功した手順だけでなく、つまずいた場所もそのまま残します。


    今回作ろうとしている仕組み

    今回の仕組みは、次の流れです。

    article.md
    記事のタイトル、タグ、本文を書く
        ↓
    Codexに「noteへ下書き保存して」と指示
        ↓
    note-post-mcpが指示を受け取る
        ↓
    PlaywrightがChromiumブラウザを自動操作
        ↓
    noteへ下書き保存、または公開
    

    MCPは、AIと外部ツールをつなぐための橋渡しです。

    今回は、Codexとnoteの間に note-post-mcp を接続します。

    このツールは、noteの公式APIを使って投稿するものではありません。

    リポジトリの説明を見る限り、Playwrightという仕組みでChromiumブラウザを操作し、記事の入力や保存を自動化しています。[1]

    利用できる主な機能は、次の2つです。

    機能内容save_draft記事をnoteの下書きとして保存するpublish_note記事をそのまま公開する

    少なくとも現在のREADMEでは、予約投稿、既存下書きの更新、既存記事の編集といった機能は確認できません。[1]

    最初から publish_note を試すのは危険です。

    誤った内容やテスト記事が、そのまま一般公開される可能性があります。

    導入時は、必ず save_draft から試します。


    作業を始める前の注意点

    今回使うツールは、ブラウザのログイン状態をファイルとして保存します。

    そのファイルを使って、Playwrightがnoteへログインした状態で操作します。

    つまり、ログイン情報を含むファイルの管理が重要です。

    また、ブラウザを自動操作する仕組みなので、note側の画面構成が変わると、動作しなくなる可能性があります。

    この記事と同じ手順でも、実行時期やPC環境によって結果が変わるかもしれません。

    以下は、あくまで自分のWindows環境で試した記録です。


    1.必要なソフトが入っているか確認する

    最初に、WindowsでPowerShellを開きます。

    スタートメニューを開き、次の文字を検索します。

    PowerShell
    

    PowerShellを開いたら、以下のコマンドを1行ずつ実行します。

    node -v
    npm -v
    git --version
    

    正常な場合は、次のようにバージョンが表示されます。

    v22.x.x
    10.x.x
    git version 2.x.x
    

    note-post-mcp のリポジトリでは、Node.js 18以上が必要とされています。[1][2]


    2.プロジェクト全体をダウンロードする

    次に、GitHubから note-post-mcp を取得します。

    PowerShellで、ドキュメントフォルダへ移動します。

    cd $HOME\Documents
    

    続いて、GitHubのリポジトリを複製します。

    git clone https://github.com/Go-555/note-post-mcp.git
    

    取得したフォルダへ移動します。

    cd note-post-mcp
    

    中身を確認します。

    dir
    

    以下のようなファイルやフォルダが表示されれば、正しい場所に移動できています。

    package.json
    package-lock.json
    README.md
    QUICKSTART.md
    src
    scripts
    

    package.json が見つからない場合

    現在いるフォルダが違う可能性があります。

    以下を実行します。

    pwd
    

    正しい場所の例は、次のとおりです。

    C:\Users\ユーザー名\Documents\note-post-mcp
    

    初心者の自分は、エラーが出るとすぐコードを疑ってしまいます。

    しかし、実際には「違うフォルダでコマンドを実行していた」だけのこともあります。

    まず、現在地とファイルの有無を確認します。


    3.Windows用にビルド設定を修正する

    ここが、Windowsでつまずきやすいポイントです。

    リポジトリの package.json には、次のビルド命令が入っています。

    tsc && chmod +x build/index.js
    

    chmod は、主にMacやLinuxでファイルの実行権限を変更するコマンドです。

    WindowsのPowerShellでは、この部分でエラーになる可能性があります。

    そのため、ビルド命令をWindows向けに変更します。

    npm pkg set scripts.build=tsc
    

    設定が変わったか確認します。

    npm pkg get scripts.build
    

    次のように表示されれば変更できています。

    "tsc"
    

    元の package.json に chmod が含まれていることは、リポジトリ上でも確認できます。[2]


    4.必要なプログラムをインストールする

    次に、必要なパッケージをインストールします。

    npm install
    

    処理が終わったら、プログラムをビルドします。

    npm run build
    

    正常に完了すると、プロジェクト内に build フォルダが作られます。

    次のコマンドで確認します。

    dir build
    

    index.js が表示されれば、ビルドは成功です。

    index.js
    

    エラーになった場合は、以下を確認します。

    ・現在地がnote-post-mcpフォルダか
    ・package.jsonが存在するか
    ・Node.jsが18以上か
    ・Windows用のビルド設定へ変更できているか
    

    5.noteを操作するChromiumをインストールする

    note-post-mcp は、Playwrightを使ってChromiumブラウザを操作します。

    次のコマンドで、Playwright用のChromiumをインストールします。

    npm run install-browser
    

    ファイルのダウンロードがあるため、少し時間がかかります。

    最後まで大きなエラーが表示されなければ完了です。

    リポジトリのクイックスタートでも、依存関係の導入後にPlaywright用Chromiumをインストールする流れになっています。[1][3]


    6.noteへログインする

    次に、Playwrightからnoteへアクセスするためのログイン状態を保存します。

    以下を実行します。

    npm run login
    

    実行すると、Chromiumブラウザが開きます。

    流れは以下です。

    1.ブラウザ上でnoteへログインする
    2.noteのホーム画面が表示されたことを確認する
    3.PowerShellへ戻る
    4.Enterキーを押す
    

    ログイン状態は、通常次の場所へ保存されます。

    C:\Users\Windowsユーザー名\.note-state.json
    

    PowerShellで存在を確認します。

    Test-Path "$HOME\.note-state.json"
    

    次のように表示されれば、ファイルが作成されています。

    True
    

    .note-state.json は絶対に共有しない

    ここは、今回の作業で最も注意すべき部分です。

    .note-state.json には、ブラウザのCookieなど、noteへログインした状態を再利用するための情報が保存されます。[1][3]

    実質的に認証情報を含む重要ファイルです。

    以下は行わないでください。

    ・ChatGPTへアップロードする
    ・Google Driveで共有する
    ・Slackへ送る
    ・GitHubへ登録する
    ・記事内で中身を公開する
    ・他人へ渡す
    

    リポジトリの .gitignore でも、認証状態ファイルがGit管理の対象外になるよう設定されています。[3]

    エラー調査をAIに頼む場合も、ファイルそのものを渡すのではなく、ファイルが存在するか、パスが正しいかだけを伝えます。


    7.CodexにMCPを登録する

    Codexは、MCPサーバーの設定を config.toml に保存します。

    Windowsでは通常、次の場所です。

    C:\Users\Windowsユーザー名\.codex\config.toml
    

    Codexの設定画面から開く場合は、次の流れです。

    右上の歯車
    ↓
    Codex Settings
    ↓
    Open config.toml
    

    Codex公式ドキュメントでも、ユーザー共通の設定は ~/.codex/config.toml、プロジェクトごとの設定は .codex/config.toml に保存する構成が案内されています。[4]

    config.toml の一番下に、以下を追加します。

    [mcp_servers.note-post-mcp]
    command = "npx"
    args = ["-y", "@gonuts555/note-post-mcp@1.0.7"]
    

    この記事では、確認時点のリポジトリの package.json に記載されていたバージョン 1.0.7 を指定しています。[2]

    バージョンを固定すると、知らない間にパッケージが更新されて挙動が変わる可能性を減らせます。

    設定を保存したら、Codexを完全に終了して再起動します。


    認証ファイルが見つからない場合

    Codexから .note-state.json を見つけられない場合は、ファイルの場所を明示します。

    [mcp_servers.note-post-mcp]
    command = "npx"
    args = ["-y", "@gonuts555/note-post-mcp@1.0.7"]
    
    [mcp_servers.note-post-mcp.env]
    NOTE_POST_MCP_STATE_PATH = "C:\\Users\\user\\.note-state.json"
    

    user の部分は、自分のWindowsユーザー名へ変更します。

    自分のホームフォルダがわからない場合は、PowerShellで以下を実行します。

    $HOME
    

    表示されたパスの末尾に .note-state.json を付けます。


    8.MCPが認識されたか確認する

    Codexを再起動したら、チャットで次のように指示します。

    現在利用できるMCPサーバーとツールを確認してください。
    
    note-post-mcpのsave_draftとpublish_noteが利用可能か確認してください。
    
    まだ投稿処理は実行しないでください。
    

    Codex CLIやターミナル画面を使っている場合は、次のコマンドでも確認できます。

    /mcp
    

    以下が認識されていれば、MCPの登録はできています。

    note-post-mcp
    save_draft
    publish_note
    

    Codexは、CLIとIDE拡張機能の両方でMCPサーバーを利用でき、/mcp で有効なサーバーを確認できます。[4]


    9.テスト用の記事を作成する

    いきなり本番の記事を投稿せず、短いテスト記事を作ります。

    PowerShellで記事用フォルダを作成します。

    mkdir $HOME\Documents\note-articles
    mkdir $HOME\Documents\note-articles\test
    cd $HOME\Documents\note-articles\test
    

    記事ファイルを作ります。

    notepad article.md
    

    「新しく作成しますか?」と表示されたら、「はい」を選びます。

    以下を貼り付けて保存します。

    ---
    title: note自動投稿のテスト記事
    tags:
      - note
      - 自動化
      - テスト
    ---
    
    これはnote-post-mcpを使った投稿テストです。
    
    ## 大見出し
    
    ここは本文です。
    
    ### 小見出し
    
    - 箇条書き1
    - 箇条書き2
    - 箇条書き3
    
    **太字のテストです。**
    
    https://note.com
    

    ファイル上部の --- で囲まれた部分は、Front Matterと呼ばれます。

    ここからタイトルとタグが読み取られます。

    本文では、見出し、太字、リスト、引用、画像、単独URLなどが利用できます。[1][3]


    10.Codexから下書き保存を実行する

    Codexで、次のフォルダをワークスペースとして開きます。

    C:\Users\Windowsユーザー名\Documents\note-articles\test
    

    Codexへ、次のように指示します。

    このワークスペースにあるarticle.mdの絶対パスを確認してください。
    
    article.mdをnoteへ下書き保存してください。
    
    必ずnote-post-mcpのsave_draftを使用してください。
    
    publish_noteは使用しないでください。
    
    絶対に一般公開しないでください。
    
    処理完了後、下書きのURLと処理結果を報告してください。
    

    途中で実行許可を求められた場合は、処理内容を確認します。

    save_draft であることを確認してから承認します。

    publish_note と表示されている場合は、承認しません。


    現在のつまずき:save_draftがタイムアウトする

    ここまでで、MCPの登録とツールの認識までは確認できました。

    しかし、save_draft を実行すると、MCPツールがタイムアウトを繰り返しています。

    そのため、現時点ではnoteへの下書き保存完了まで確認できていません。

    この記事も、ここまでが実際に進められた範囲です。

    「自動投稿できました」とは、まだ書けません。


    タイムアウトの原因として次に確認すること

    次に確認する予定なのは、以下です。

    ・Codex側のツール実行時間が短すぎないか
    ・note-post-mcp側のタイムアウト設定が正しいか
    ・NOTE_POST_MCP_STATE_PATHが正しいか
    ・noteのログイン状態が期限切れになっていないか
    ・PlaywrightのChromiumが正常に起動できるか
    ・Codexを介さず、ローカルでMCPサーバーが起動するか
    

    CodexのMCPツールは、設定しない場合の実行タイムアウトが60秒です。

    一方、note-post-mcp のブラウザ操作タイムアウトは、README上では初期値が180秒になっています。[1][4]

    この差が、今回のタイムアウトに関係している可能性があります。

    まだ解決を確認できていないため、現時点では仮説です。

    次に試す候補は、config.toml にCodex側とMCP側のタイムアウトを明示する方法です。

    [mcp_servers.note-post-mcp]
    command = "npx"
    args = ["-y", "@gonuts555/note-post-mcp@1.0.7"]
    startup_timeout_sec = 30
    tool_timeout_sec = 240
    
    [mcp_servers.note-post-mcp.env]
    NOTE_POST_MCP_STATE_PATH = "C:\\Users\\user\\.note-state.json"
    NOTE_POST_MCP_TIMEOUT = "180000"
    

    この設定は、まだ自分の環境で動作確認できていません。

    実行結果を確認してから、正式な手順として追記します。


    ここまででわかったこと

    まだ下書き保存は完了していません。

    ただ、ここまで進めたことで、note自動投稿の仕組みはかなり見えてきました。

    Markdownで記事を書く
    ↓
    Codexが記事ファイルを確認する
    ↓
    MCPでPlaywrightを呼び出す
    ↓
    ブラウザへ記事を入力する
    ↓
    下書き保存または公開する
    

    また、今回の作業では、いくつか重要なこともわかりました。

    ・Windowsではビルド命令の修正が必要になる場合がある
    ・最初から公開せず、save_draftで試す
    ・note-state.jsonは絶対に共有しない
    ・MCPが表示されても、投稿処理まで成功するとは限らない
    ・ブラウザ操作には時間がかかるため、タイムアウト設定も確認する
    ・公式APIではなくブラウザ操作なので、画面変更の影響を受ける可能性がある
    

    MCPを登録できたから完成、ではありませんでした。

    認証ファイル、ブラウザ、実行時間、記事ファイル、Codex側の設定がすべてつながって、初めて投稿できます。


    続きは解決後に追記します

    現在は、save_draft のタイムアウトを解消し、実際にnoteの下書き画面へ記事を保存する方法を確認しています。

    解消できたら、次の内容を追記します。

    ・タイムアウトの原因
    ・変更したconfig.toml
    ・実際に成功したCodexへの指示
    ・note側で下書きを確認する方法
    ・画像付き記事を保存する方法
    ・公開前に確認すべき項目
    ・publish_noteを使う場合の注意点
    

    成功した部分だけではなく、どこで止まり、どう直したのかまで残します。

    ここまで試した続きや、タイムアウトの解決方法を見逃したくない方は、フォローしていただくと次の記事を見つけやすくなります。

    導入完了まで、もう少しお待ちください。

    この記事が参加している募集

     
     
    AIの活用事例や最新情報を、実際に使った活用事例、中級者でもつまづきそうになる点などを、日本一わかりやすくを目標に取り組んでいます。 【メインコンテンツ】 大規模言語モデル、ChatGPT、CodeX、画像生成、アプリ制作、デザインなど

    あなたへのおすすめ