MCPのツール一覧を調べて、記事を1件読む
配布教材のサイトに読み取り専用で接続します。tools/list で必要な引数を調べ、content_get に記事のスラッグを渡してタイトルを表示します。
目次
MCPで自分のサイトの記事を読むには、まず接続先に「何ができる?」と問い合わせ、次に使いたいツールと引数を送ります。ここでは練習サイト「週末ノート」から 「週末の記録 01」 を読み取ります。AIアプリの代わりに短いプログラムを使うので、何を送って何が返ったかを自分で確かめられます。
手元に練習サイトを用意する
用意するのは、Node.js 24.22.1以降と、パスキー(端末の画面ロックなどを使うログイン方法)を登録できるブラウザー・端末です。Node.jsやコマンド入力画面を初めて使う人は、パソコンの準備から始めてください。
共通教材(ZIP)を新しいフォルダーに展開します。VS Codeの「ファイル → フォルダーを開く」で、README.md・publish-check・weekend-note が並ぶフォルダーを開いてください。この実習では、ここから4365番の練習サイトを作り、そこで専用のトークンを発行します。共通教材のREADMEにある4350番の起動手順は飛ばして、この先を進めます。
VS Codeの「ターミナル → 新しいターミナル」でコマンド入力画面を開きます。Windowsでは「コマンドプロンプト」を選びます。次を1行ずつ実行してください。最初の3行で教材のプラグインを準備し、cd ../weekend-note でサイト本体のフォルダーへ移ります。
cd publish-check
npm ci
npm run build
cd ../weekend-note
npm ci
npx emdash seed seed/seed.json
npm run build
npm ls @modelcontextprotocol/sdk最後の行で、MCPに接続するための部品 @modelcontextprotocol/sdk@1.32.2 を確認します。この版は教材の package-lock.json に記録されており、npm ci でEmDashと一緒に入ります。
VS Code左のファイル一覧で weekend-note を右クリックして「新しいファイル」を選び、.env.mcp-server を作ります。weekend-note/package.json と並ぶ場所です。次の2行を保存します。
PORT=4365
EMDASH_SITE_URL=http://localhost:4365同じ weekend-note フォルダーでサイトを起動します。このコマンド入力画面は最後まで開いておきます。
node --env-file=.env.mcp-server scripts/start.mjsコマンド入力画面に Server listening on http://127.0.0.1:4365 と出たら起動できています。ブラウザーのアドレス欄には http://localhost:4365/_emdash/admin と入力してください。パスキーで使うサイト名を、先ほど設定した localhost にそろえるためです。
初回は次の順で管理者を登録します。
- Site Title に「週末ノート」と入力し、Sample content を選んで Continue を押します。
- 練習サイトの管理者として使うメールアドレスと名前を入力し、Continue を押します。
- Create passkey で端末の案内に従ってパスキーを作ります。Open the dashboard が出たら登録できています。そのボタンを押し、初回の案内を Get Started で閉じます。
記事を読むためのトークンを作る
ブラウザーではパスキーでログインしました。これから実行するプログラムには、どこまで操作してよいかを指定した「トークン」を渡します。
- 練習サイトの管理画面で Settings → API Tokens を開きます。直接開く場合は
http://localhost:4365/_emdash/admin/settings/api-tokensです。 - Create Token を押し、名前に
MCP reading practiceと入力します。Scopes は Content Read だけにチェックを入れます。これがcontent:read(記事を読む権限)です。 - Expiry で有効期限を確認し、Create Token を押します。トークンは点で隠れていても、横の Copy token ボタンでコピーできます。値をコピーできるのは作成直後のこの画面だけです。
.env.mcp-serverと同じ場所に、もう1つ.env.mcp-localを作ります。次の行の「ここに貼り付ける」をコピーした値に置き換えて保存します。このファイルは自分のパソコンだけに置いてください。別の練習サイトで発行したトークンは、このサイトには使えません。
EMDASH_TOKEN=ここに貼り付けるツールが求める引数を調べ、記事を読む
weekend-note/scripts に read-mcp.mjs というファイルを作り、次のコードを保存します。プログラムの前半でツールの説明を取り出し、後半で実際に記事を読みます。
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
const token = process.env.EMDASH_TOKEN;
if (!token) throw new Error('.env.mcp-local の EMDASH_TOKEN を確認してください');
const client = new Client({ name: 'weekend-note-reader', version: '1.0.0' });
const url = new URL('http://localhost:4365/_emdash/api/mcp');
const transport = new StreamableHTTPClientTransport(url, {
requestInit: { headers: { Authorization: `Bearer ${token}` } },
});
try {
await client.connect(transport);
const { tools } = await client.listTools();
const tool = tools.find(({ name }) => name === 'content_get');
if (!tool) throw new Error('content_get が見つかりません');
console.log('ツール:', tool.name);
console.log('必須の引数:', tool.inputSchema.required.join(', '));
const result = await client.callTool({
name: tool.name,
arguments: { collection: 'posts', id: process.argv[2] ?? 'note-01' },
});
const block = result.content.find(({ type }) => type === 'text');
if (result.isError || !block) throw new Error(block?.text ?? '応答に本文がありません');
const { item } = JSON.parse(block.text);
console.log('記事:', item.slug, item.status, item.data.title);
} finally {
await client.close();
}サイトを起動した画面は開いたまま、VS Code左側の weekend-note フォルダーを右クリックし、「統合ターミナルで開く」 を選びます。これで2つ目のコマンド入力画面が、.env.mcp-local のある場所から始まります。次のコマンドはこちらに入力します。
node --env-file=.env.mcp-local scripts/read-mcp.mjsサンプル記事を編集していなければ、次の3行が表示されます。最後の行に「週末の記録 01」が出たら、ツールの一覧取得から記事の読み取りまで成功です。
ツール: content_get
必須の引数: collection, id
記事: note-01 published 週末の記録 01| コードの場所 | 何を確かめたか |
|---|---|
client.listTools() | MCPの tools/list で接続先のツール一覧を受け取ります。その中から記事を1件読む content_get を探し、inputSchema.required にある必須の引数名を表示しました。 |
client.callTool(...) | MCPの tools/call でツールを実行します。collection には記事の入れ物 posts、id には読みたい記事を指定します。EmDashの content_get では記事のIDのほか、URLに使う名前(スラッグ)も渡せます。 |
JSON.parse(block.text) | このツールは記事のデータをJSON形式の文字列で返します。読みやすい形に戻し、item.slug(スラッグ)、item.status(ここでは公開済み)、item.data.title(タイトル)の順に表示しました。 |
うまく読めなかったら
記事の指定ミスは、認証に失敗したときと表示が違います。試しに、教材に存在しないスラッグを末尾に付けて実行します。
node --env-file=.env.mcp-local scripts/read-mcp.mjs missing-noteツール名と必須の引数を表示した後に [NOT_FOUND] Content item not found: missing-note と出ます。ここまで接続はできています。読みたい記事が posts にあるか、スラッグが合っているかを確かめてください。最初から 401 が出た場合は、練習サイトが発行したトークンを貼ったか、有効期限が切れたり失効したりしていないかを確認しましょう。
練習が終わったら
管理画面の API Tokens で、MCP reading practice の行の Revoke token を押し、確認画面で Confirm を選びます。2つ目のコマンド入力画面で、記事を読めたときのコマンドをもう一度実行してください。401 が返ったら、取り消したトークンでの接続が止まったことを確認できました。
最後に .env.mcp-local を削除し、サイトを起動している1つ目のコマンド入力画面で Ctrl + C を押します。
接続先や用途別の権限を調べるときは、MCPで利用できる操作を調べるに一覧があります。