MCPサーバーの使い方
Memoreru MCPサーバー
Memoreru MCPサーバーを使うと、Claude DesktopやCursorなどのAIツールから直接Memoreruのデータを操作できます。
MCPとは
MCP(Model Context Protocol)は、AIアシスタントが外部サービスのデータにアクセスするための標準プロトコルです。Memoreru MCPサーバーを設定すると、AIとの会話の中でMemoreruのコンテンツを読み書きできるようになります。
利用条件
MCPサーバーはライトプラン以上でご利用いただけます。機能トライアル期間中も利用できます。事前にAPIキーの発行が必要です。
セットアップ
1. APIキーの取得
設定 > セキュリティの「APIキー」カードからAPIキーを発行してください。mk_ で始まる文字列がAPIキーです。
2. MCPサーバーの設定
ご利用のAIツールの設定ファイルに、以下の接続情報を追加してください。
接続情報:
| 項目 | 値 |
|---|---|
| URL | https://memoreru.com/api/mcp |
| 認証ヘッダー | Authorization: Bearer mk_あなたのAPIキー |
設定ファイルの場所と形式:
| ツール | 設定ファイル |
|---|---|
| Claude Desktop | claude_desktop_config.json |
| Cursor | Settings > MCP |
| Claude Code | .mcp.json(プロジェクトルート) |
| VS Code | settings.json |
設定例(Claude Desktop / Cursor):
{
"mcpServers": {
"memoreru": {
"url": "https://memoreru.com/api/mcp",
"headers": {
"Authorization": "Bearer mk_あなたのAPIキー"
}
}
}
}Claude Code と VS Code では "type": "http" の指定が必要です。VS Code は "mcp" > "servers" の階層になります。
3. 動作確認
設定後、AIツールを再起動し、「Memoreruのコンテンツ一覧を表示して」と話しかけてみてください。
ツール一覧
MCPサーバーには15個のツールがあります。
コンテンツ操作(5ツール)
| ツール名 | 説明 |
|---|---|
create_contents | コンテンツを作成(table, page, slide, folder, view, graph, dashboard) |
read_contents | コンテンツを取得。IDで詳細、省略で一覧(フィルタ・ソート対応) |
update_contents | タイトル・説明・スコープの変更、列の追加・更新・削除 |
delete_contents | コンテンツを削除(取り消し不可) |
count_contents | コンテンツ数を取得(スコープ別) |
テーブル操作(10ツール)
| ツール名 | 説明 |
|---|---|
create_columns | テーブルに列を追加(1件〜複数件) |
read_columns | テーブルの列定義を取得 |
update_columns | テーブルの列定義を更新 |
delete_columns | テーブルから指定した列を削除(列IDの指定が必須) |
create_rows | 行を作成(1件〜100件)。列の表示名で指定可能 |
read_rows | 行を取得。IDで詳細、省略で一覧(フィルタ・ソート・検索対応) |
update_rows | 行を更新(1件〜100件)。列の表示名で指定可能 |
delete_rows | 行を削除(1件〜複数件) |
count_rows | テーブルの行数を取得 |
upsert_rows | 条件一致で更新、なければ作成(1件〜100件) |
ツールの詳細
create_contents
コンテンツを作成します。テーブルの場合は列定義、view/graph/dashboardの場合はsettingsも同時に設定できます。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
title | string | ○ | タイトル |
content_type | string | ○ | タイプ(table, page, slide, folder, view, graph, dashboard) |
scope | string | - | 公開範囲(public, private)。デフォルト: private |
description | string | - | 説明文 |
columns | array | - | 列定義(tableのみ。name, type, required, options を指定) |
settings | object | - | タイプ別設定(view, graph, dashboardで必須) |
read_contents
コンテンツを取得します。content_id を指定すると詳細、省略すると一覧を返します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
content_id | string | - | コンテンツID(指定で詳細、省略で一覧) |
content_type | string | - | タイプでフィルタ(table, page, slide, graph, dashboard, folder) |
scope | string | - | スコープ(public, private, all)。デフォルト: private |
search | string | - | キーワード検索 |
page | number | - | ページ番号 |
limit | number | - | 件数(デフォルト: 20) |
sort | string | - | ソート(created_at, updated_at, title) |
order | string | - | ソート順(asc, desc) |
create_rows
テーブルに行を作成します。1件でも複数件でも配列で指定します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
table_id | string | ○ | テーブルのコンテンツID |
rows | array | ○ | 行データの配列(各要素は列の表示名 → 値)。最大100件 |
read_rows
テーブル行を取得します。row_id を指定すると1件の詳細、省略すると一覧を返します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
table_id | string | ○ | テーブルのコンテンツID |
row_id | string | - | 行ID(指定で詳細、省略で一覧) |
page | number | - | ページ番号 |
limit | number | - | 件数(デフォルト: 100、最大: 500) |
q | string | - | テキスト検索クエリ |
filters | array | - | フィルタ条件(AND結合) |
sorts | array | - | ソート設定(優先順) |
フィルタの指定方法:
[
{
"columnId": "列ID",
"columnType": "checkbox",
"operator": "eq",
"value": false
}
]対応する演算子: eq, neq, like, in, notIn, gt, gte, lt, lte, between, null, notNull, contains, notContains, startsWith, endsWith
ソートの指定方法:
[
{ "columnId": "列ID", "order": "asc" }
]update_rows
テーブル行を更新します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
table_id | string | ○ | テーブルのコンテンツID |
updates | array | ○ | 更新データの配列。各要素に row_id と cells(列の表示名 → 値)を指定。最大100件 |
delete_rows
テーブルから行を削除します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
table_id | string | ○ | テーブルのコンテンツID |
row_ids | array | ○ | 削除する行IDの配列 |
upsert_rows
指定した列の値で行を検索し、存在すれば更新、なければ作成します。1件でも複数件でも対応。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
table_id | string | ○ | テーブルのコンテンツID |
match_column | string | ○ | 一致判定に使う列(表示名またはID) |
items | array | ○ | upsertデータの配列。各要素に match_value と cells を指定。最大100件 |
レスポンスの action に "created", "updated", "unchanged" のいずれかが返ります。
便利な機能
列の表示名での操作
行の作成・更新時に、列IDの代わりに表示名でデータを指定できます。
「タスク名」:「買い物リストの作成」のように指定してください
内部で自動的に列IDに変換されます。
対応データ型
テーブルの列には30種類のデータ型が利用できます。
基本型: string, number, checkbox
選択型: select, radio, multi_select
日時型: date, datetime, time
テキスト型: markdown, rich_text, url
計算型: formula, rating, progress
参照型: rollup, location, image
メディア型: audio, video, file
組織型 (有料): user_select, team_select, dept_select
埋め込み型 (有料): sub_table, embed, qr_code
特殊型 (有料): auto_number, drawing, button
仮想型: mirror
使い方の例
テーブルの作成:
「Memoreruに"読書記録"テーブルを作成して。列はタイトル(string)、著者(string)、読了日(date)、評価(rating)」
テーブルデータの確認:
「タスク管理テーブルの未完了タスクを一覧で見せて」
データの追加:
「タスク管理テーブルに新しいタスクを追加して。タイトルは〇〇、担当者は△△」
データの一括追加:
「読書記録テーブルに以下の3冊を追加して:...」
データの更新:
「タスク管理テーブルのID 5のタスクのステータスを完了に変更して」
条件付き更新(upsert):
「タスク管理テーブルで"週次レポート作成"という名前のタスクがあれば期限を来週金曜に更新して、なければ新規作成して」
コンテンツの検索:
「Memoreruで"会議"に関するコンテンツを検索して」
フィルタ付き一覧:
「プロジェクト管理テーブルで、ステータスが"進行中"のものだけ優先度順に表示して」