メインコンテンツまでスキップ

MCPアクセス(AIエージェント)

最近の変更

MCPはiPhoneでも完全に利用可能になりました(ウェブアプリに加えて)。iPhoneの画面はウェブと同じで、対応するすべてのAIクライアント向けに同じセットアップスニペットを含みます。

Pro以上のプラン

MCPアクセスにはProまたはUltraプランが必要です。両プランとも完全な読み取り+書き込みアクセス(20ツール)を取得します。Ultraはより高いクォータを持ち、読み取り専用モードへの切り替えもできます。

MCP(Model Context Protocol)を使うと、AIコーディングアシスタントや自動化ツールをTellDoneのデータに直接接続できます。接続すると、AIエージェントはノート、タスク、イベント、レポートを読み取り、項目を作成・更新・削除できます。合計20ツール: データ読み取り用が9、書き込み用が11あります。

iPhoneアプリ(設定 → 連携 → AIエージェント)とウェブアプリ(設定 → AIエージェント)の両方で利用できます。

プランの要件​

プランMCP
Freeロック
Basicロック
Pro読み取り+書き込み(20ツール)
Ultra読み取り+書き込み(20ツール、より高いクォータ) - 読み取り専用モードに切り替え可能

アプリ内画面​

AIエージェント画面はプランとMCPがオンになっているかによって3つの状態を持ちます。

ロック中(FreeとBasic)​

FreeまたはBasicプランの場合、画面はMCPが何をするか説明し、アップグレードボタンを表示します。タップするとペイウォールが開き、ProまたはUltraに移れます。

無効(Pro/Ultra、機能オフ)​

ProまたはUltraだがMCPをまだオンにしていない場合、画面はプランで何ができるかの短いサマリー(ツール数、アクセスモード、クォータ)と有効化ボタンを表示します。タップして接続トークンを生成し、連携を開始してください。

有効​

有効化されると、画面はAIクライアントの接続に必要なすべてを表示します:

  • モード切り替え - Ultraでは読み取り専用と読み取り+書き込みを切り替えられます。Proではモードは読み取り+書き込みで固定です。
  • アクセストークン行 - トークンを表示/非表示する目玉トグルとコピーボタン付き。
  • セットアップピッカー - Claude Code、Cursor、Windsurf、その他のタブ付き。タブの下に該当するコードスニペットが表示されます。コピーしてAIクライアントに貼り付けるだけです。
  • 再生成ボタン - トークンをすぐにローテーションし、古いものを使うアクティブなセッションを切断します。
  • 無効化ボタン - MCPをオフにしてトークンを削除します。後で再有効化できますが、新しいトークンが発行されます。
ヒント

接続トークンは非公開にしてください。トークンを持つ誰でもTellDoneのデータにアクセスできます。トークンが漏れたと疑う場合は再生成を使ってください。

有効化方法​

どちらのプラットフォームからでもMCPを設定できます:

  • iPhone: 設定 → 連携 → AIエージェント(MCP)
  • ウェブ: app.telldone.app → 設定 → AIエージェント

手順:

  1. 有効化をタップ。
  2. アクセスモードを選択(Ultraのみ - Proは常に読み取り+書き込み)。
  3. 目玉とコピーアイコンを使ってトークンを表示・コピー。
  4. セットアップセクションでツールを選択(Claude Code、Cursor、Windsurf、その他)。
  5. スニペットをAIクライアントの設定に貼り付け。

AIツールの接続​

アプリ内セットアップピッカーの4つのタブ(Claude Code、Cursor、Windsurf、その他)は以下のセクションに対応します。すべての例でYOUR_TOKENを設定からのトークンに置き換えてください。

Claude Code​

ターミナルでこのコマンドを実行:

claude mcp add telldone --transport http \
  https://api.telldone.app/mcp/user/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Cursor​

.cursor/mcp.jsonに追加:

{
  "mcpServers": {
    "telldone": {
      "url": "https://api.telldone.app/mcp/user/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Windsurf​

.codeium/windsurf/mcp_config.jsonに追加:

{
  "mcpServers": {
    "telldone": {
      "serverUrl": "https://api.telldone.app/mcp/user/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

その他​

アプリ内ピッカーでその他にグループ化されているクライアント向けのスニペットです。

Codex​

codex.jsonに追加:

{
  "mcpServers": {
    "telldone": {
      "type": "http",
      "url": "https://api.telldone.app/mcp/user/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

OpenClaw​

設定 > MCP Servers > 追加:

  • 名前: TellDone
  • URL: https://api.telldone.app/mcp/user/mcp
  • 認証: Bearer YOUR_TOKEN

その他のMCPクライアント​

HTTP上のMCPをサポートする任意のツールが接続できます。エンドポイントhttps://api.telldone.app/mcp/user/mcpをBearer YOUR_TOKEN認証ヘッダーとともに使用してください。

代替の認証ヘッダー

クライアントやプロキシがAuthorizationヘッダーを予約している場合(例えば一部のSmithery形式のゲートウェイ)、トークンを代わりにX-MCP-Token: YOUR_TOKENで送信してください。両方のヘッダーが動作します。両方が存在する場合、Authorizationが優先されます。

接続のテスト​

シンプルなcURLコマンドでトークンが動作するか確認できます:

curl -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

成功した応答は利用可能なすべてのツールを一覧表示します。

何ができるか​

読み取りツール(9) - ProとUltra​

ツール機能
get_notesフィルター(タグ、日付範囲、テキスト検索)付きでノートを一覧
get_note子タスク、イベント、完全な文字起こし付きで単一ノートを表示
get_notes_full1回の呼び出しで埋め込みタスクとイベント付きの複数ノートを取得
get_tasksステータス(to-do、done、all)、タグ、日付でフィルターしたタスクを一覧
get_eventsカレンダーイベントを一覧、日付範囲でフィルター
get_reports日次、週次、月次、年次レポートを読み取り(完全なMarkdown)
get_tags使用順にソートされたすべてのタグを表示
get_profileアカウント情報と使用統計を表示
searchノート、タスク、イベント全体を検索(ノートにはテキスト+セマンティック検索)
ヒント

searchツールはノートのセマンティック検索をサポートします。キーワードだけでなく意味で結果を見つけます。例えば「予算に関する会議」で検索すると、「予算」という言葉が含まれていなくても財務に関する議論のノートが見つかります。

書き込みツール(11) - ProとUltra​

ツール機能
process_note完全なAIパイプライン - テキストまたはオーディオを送信、タスク、イベント、タグ付きのノートを返す
create_noteプレーンテキストノートを追加(AI分析なし)
create_task優先度、期限、リマインダー、タグ付きでタスクを追加
create_event日付、時刻、場所、リマインダー、参加者、繰り返し付きでカレンダーイベントを追加
update_noteノートのタイトル、要約、タイプ、タグ、優先度、ステータスを変更
update_taskタスクのタイトル、説明、優先度、期限、リマインダー、タグ、ステータスを変更
complete_taskタスクを完了としてマーク
update_eventイベントの詳細、時刻、場所、リマインダー、参加者、繰り返し、タグ、ステータスを変更
delete_noteノートとそのリンクされたすべてのタスクとイベントを削除
delete_taskタスクを削除
delete_eventイベントを削除

すべての書き込みおよび削除操作は、リアルタイム同期で接続デバイス(電話、ウェブアプリ)に即座に表示されます。

ツールリファレンス​

get_notes​

任意のフィルターでノートを一覧。日付フィルターはrecorded_at(音声ノートを録音したとき)を使い、created_atは使いません。

パラメータータイプデフォルト説明
limitint20返すノート数(最大50)
offsetint0この数のノートをスキップ(ページング、最大10000)
tagsstring-タグでフィルター、カンマ区切り(いずれかに一致)
searchstring-タイトルと要約でテキスト検索
date_fromstring-開始日、YYYY-MM-DD(包含)
date_tostring-終了日、YYYY-MM-DD(排他)

戻り値: id、title、summary、type、tags、priority、status、recorded_at、created_atを持つノート一覧。

get_note​

完全な文字起こしとリンクされたすべてのタスクとイベント付きで単一ノートを取得。

パラメータータイプ説明
note_idstringノートのUUID

戻り値: title、summary、transcript、type、tags、priority、status、metadata、created_at、加えてtasks[]とevents[]配列。

get_notes_full​

1回の呼び出しでタスクとイベント付きの複数ノートを取得。get_notesと同じフィルターを持ちますが、各ノートには埋め込みのtasks[]とevents[]が含まれます。

パラメータータイプデフォルト説明
limitint10ノート数(最大20)
offsetint0この数のノートをスキップ
tagsstring-タグでフィルター
date_fromstring-開始日、YYYY-MM-DD
date_tostring-終了日、YYYY-MM-DD

get_tasks​

フィルター付きでタスクを一覧。

パラメータータイプデフォルト説明
statusstring"todo"フィルター: todo、done、またはall
limitint30タスク数(最大100)
offsetint0この数のタスクをスキップ
tagsstring-タグでフィルター、カンマ区切り
date_fromstring-開始日、YYYY-MM-DD(deadlineでフィルター。deadlineのないタスクは除外されます)
date_tostring-終了日、YYYY-MM-DD(deadlineでフィルター。deadlineのないタスクは除外されます)

戻り値: id、title、description、status、priority、tags、deadline、reminder_at、completed_at、completed_by、source、created_atを持つタスク一覧。

get_events​

日付範囲フィルター付きでカレンダーイベントを一覧。

パラメータータイプデフォルト説明
limitint30イベント数(最大100)
offsetint0この数のイベントをスキップ
date_fromstring-開始日、YYYY-MM-DD(イベント開始時刻でフィルター)
date_tostring-終了日、YYYY-MM-DD

戻り値: id、title、description、status、start_at、end_at、location、is_all_day、tags、created_atを持つイベント一覧。

注記

get_eventsはattendees、reminder_minutes、recurrence_ruleを返しません。これらはcreate_event/update_eventで書き込み可能ですが、リスト出力には含まれません。必要な場合はget_noteで親ノートを取得してください。

get_reports​

完全なMarkdownコンテンツでAI生成レポートを取得。

パラメータータイプデフォルト説明
report_typestring"daily"タイプ: daily、weekly、monthly、またはyearly
limitint5レポート数(最大10)

戻り値: id、type、period_start、period_end、content_md、created_atを持つレポート一覧。

注記

月次レポートは3,000~5,000語にもなります。AIツールのコンテキストウィンドウが厳しい場合はlimit=1を使ってください。

get_tags​

ピン留めを最初に、次に使用回数でソートされたすべてのタグを取得。

パラメーターなし。各々がtag、usage_count、is_pinned、is_manualを持つ最大100のタグを返します。

get_profile​

アカウント情報と使用統計を取得。

パラメーターなし。email、display_name、locale、transcription_locale、timezone、subscription、mcp_mode、created_at、stats(ノート/タスク/イベント数)を返します。

ノート、タスク、イベントを一度に検索。ノートにはテキスト検索とセマンティック検索(AI埋め込みを使って意味で結果を見つける)の両方をサポート。

パラメータータイプデフォルト説明
querystring必須検索テキスト(最大500文字)
limitint20タイプごとの最大結果数(最大20)
semanticbooltrueノートのセマンティック検索を有効化

タイプ別にグループ化された結果を返します: notes[]、tasks[]、events[]。各結果はid、type、title、detail、created_atを持ちます。

より高速なテキストのみ検索のためにsemantic=falseを設定。

process_note(ProとUltra)​

完全なAIパイプライン - アプリで録音するのと同じように動作します。テキストまたはオーディオを送信すると、TellDoneは文字起こし、AI分析を行い、抽出されたタスク、イベント、タグ、埋め込み付きの構造化されたノートを作成します。

このツールは非同期です: audio_idを返してすぐに戻り、バックグラウンドで処理します。結果は接続デバイスへのリアルタイム同期で届くか、get_notes()でポーリングできます。

パラメータータイプ説明
textstring分析するテキスト(オーディオが提供されない場合は文字起こしをスキップ)
audio_base64stringBase64エンコードされたオーディオファイル(最大50MB、文字起こしをトリガー)
audio_formatstringm4a、ogg、wav、mp3、aac、webm(デフォルト: m4a)
parent_task_idstringフォローアップ先のタスクのUUID
parent_note_idstringフォローアップ先のノートのUUID
parent_event_idstringフォローアップ先のイベントのUUID

textまたはaudio_base64のいずれかを提供する必要があります(両方も可能 - オーディオが文字起こしで優先されます)。

戻り値: {"audio_id": "...", "status": "processing", "mode": "text-only"}、またはオーディオが提供された場合は"mode": "audio+stt"。

注記

process_noteはプランのクォータ(1日のアップロード、月のノート、最大テキスト長)の対象です。get_profileで現在の使用状況を確認してください。

create_note(ProとUltra)​

プレーンテキストノートを即座に作成。AI分析をトリガーしません。タスクやイベントは抽出されません。タスク/イベント抽出付きの完全なAI分析には、代わりにprocess_noteを使ってください。

パラメータータイプ上限説明
titlestring200文字必須
summarystring1000文字任意。短いティーザー(1~3文)。レポートのプロンプトに含まれるので簡潔に
transcriptstringプラン依存任意。ノート詳細に表示される長文本文。レポートには含まれません。上限: Free 2,000 / Basic 8,000 / Pro 20,000 / Ultra 50,000文字
typestring-任意。task、idea、info(デフォルト)、status、meeting、event、reflection
tagsstring20タグカンマ区切り、任意

create_task(ProとUltra)​

新しいタスクを作成。

パラメータータイプ上限説明
titlestring200文字必須
descriptionstring2000文字任意
prioritystring-low、medium(デフォルト)、high
deadlinestring-YYYY-MM-DD、任意
reminder_atstring-ISO 8601日時(例: 2026-04-15T09:00:00Z)、任意
tagsstring20タグカンマ区切り、任意
note_idstring-親ノートにタスクをリンクするUUID、任意

create_event(ProとUltra)​

カレンダーイベントを作成。

パラメータータイプ上限説明
titlestring200文字必須
start_atstring-ISO 8601日時、必須
end_atstring-ISO 8601日時(デフォルト: start + 1時間)
descriptionstring2000文字任意
locationstring200文字任意
is_all_daybool-デフォルト: false
tagsstring20タグカンマ区切り、任意
reminder_minutesstring-イベント前のカンマ区切り分数(例: 15,60)、任意
attendeesstring-カンマ区切りの名前またはメール、任意
recurrence_rulestring-RRULE文字列(例: FREQ=WEEKLY;BYDAY=MO,WE,FR)、任意
note_idstring-親ノートにイベントをリンクするUUID、任意

update_note(ProとUltra)​

既存ノートの1つ以上のフィールドを更新。提供されたフィールドのみ変更されます。

パラメータータイプ説明
note_idstring必須、ノートのUUID
titlestring新しいタイトル(最大200文字)
summarystring新しい要約(最大1000文字、クリアにはスペース" "を渡す)
transcriptstring新しい文字起こし(プラン依存上限、クリアにはスペース" "を渡す)
typestringtask、idea、info、status、meeting、event、reflection
tagsstringカンマ区切りタグ(既存タグをすべて置換、最大20)
prioritystringlow、medium、high
statusstringactiveまたはarchived
注意

音声パイプラインで作成されたノートでは、transcriptは元の音声からテキストへの出力です。上書きすると正規ソースを置き換えます。元のものを保存したい場合は、上書きではなく追記を検討してください。

update_task(ProとUltra)​

既存タスクの1つ以上のフィールドを更新。提供されたフィールドのみ変更されます。

パラメータータイプ説明
task_idstring必須、タスクのUUID
titlestring新しいタイトル
descriptionstring新しい説明(クリアにはスペース" "を渡す)
prioritystringlow、medium、high
deadlinestringYYYY-MM-DD(クリアにはスペースを渡す)
statusstringtodoまたはdone
tagsstringカンマ区切りタグ(既存タグをすべて置換、最大20)
reminder_atstringISO 8601日時(クリアにはスペースを渡す)

statusをdoneに設定すると、タスクが完了した時刻と方法も記録されます。

complete_task(ProとUltra)​

タスクを完了としてマークするショートカット。

パラメータータイプ説明
task_idstring必須、タスクのUUID

タスクが存在しないか、すでに完了している場合はエラーを返します。

update_event(ProとUltra)​

既存イベントの1つ以上のフィールドを更新。提供されたフィールドのみ変更されます。

パラメータータイプ説明
event_idstring必須、イベントのUUID
titlestring新しいタイトル
descriptionstring新しい説明(クリアにはスペースを渡す)
start_atstring新しい開始時刻(ISO 8601)
end_atstring新しい終了時刻(ISO 8601)
locationstring新しい場所(クリアにはスペースを渡す)
statusstringconfirmed、tentative、cancelled
tagsstringカンマ区切りタグ(既存タグをすべて置換、最大20)
is_all_daystring"true"または"false"
reminder_minutesstringイベント前のカンマ区切り分数(例: 15,60)
attendeesstringカンマ区切りの名前またはメール
recurrence_rulestringRRULE文字列(クリアにはスペースを渡す)

delete_note(ProとUltra)​

ノートを削除。これによりこのノートから作成されたすべてのタスクとイベントも削除されます。

パラメータータイプ説明
note_idstring必須、ノートのUUID

delete_task(ProとUltra)​

タスクを削除。

パラメータータイプ説明
task_idstring必須、タスクのUUID

delete_event(ProとUltra)​

イベントを削除。

パラメータータイプ説明
event_idstring必須、イベントのUUID

入力の上限​

フィールド最大長使用箇所
title200文字ノート、タスク、イベントの作成/更新
description2,000文字タスク、イベントの作成/更新
summary1,000文字(ハード)ノートの作成/更新。レポートのプロンプトに含まれ、トークンコストを抑えるために短く保たれます
transcriptプラン依存: Free 2,000 / Basic 8,000 / Pro 20,000 / Ultra 50,000ノートの作成/更新。長文本文、レポートには含まれない
location200文字イベントの作成/更新
tags20タグノート、タスク、イベントの作成/更新
検索クエリ500文字search
audio_base64(デコード後)50 MBprocess_note

上限を超えると、ツールは"title too long (max 200 chars, got 250)"のようなエラーメッセージを返します。

エラー処理​

すべてのツールはJSONを返します。エラーはこの形式を使います:

{"error": "description of what went wrong"}

よくあるエラー:

エラータイミング
"MCP access is read-only..."読み取り専用モードで書き込みツールを呼び出した
"Invalid note_id format"UUIDではない文字列をIDとして渡した
"Note not found"IDが存在しないか、別のユーザーに属する
"Task not found or already completed"存在しないか完了済みタスクでcomplete_taskを呼んだ
"title too long (max 200 chars, got N)"入力上限を超えた
"Too many tags (max 20)"20を超えるタグが提供された

HTTPレベルのエラー:

コード意味
401無効なまたは欠落したBearerトークン
403MCP無効、またはプランがMCPを許可しない
429レート制限超過(5 req/s)

使用例​

すべての例はMCP JSON-RPCプロトコルでcURLを使います。YOUR_TOKENを接続トークンに置き換えてください。

データの読み取り​

# Get your profile and stats
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"get_profile"}}'

# List recent notes (limit 5, from April 2026)
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"get_notes","arguments":{"limit":5,"date_from":"2026-04-01"}}}'

# Search notes (hybrid text + semantic)
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
       "params":{"name":"search","arguments":{"query":"project deadline","limit":5}}}'

データの書き込み(ProとUltra)​

# Process a note through full AI pipeline (extracts tasks + events)
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":10,"method":"tools/call",
       "params":{"name":"process_note","arguments":{"text":"Need to buy groceries tomorrow. Meeting with Katie at 3pm at the cafe to discuss the project."}}}'

# Create a task with deadline and reminder
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":11,"method":"tools/call",
       "params":{"name":"create_task","arguments":{"title":"Review PR","priority":"high","deadline":"2026-04-15","reminder_at":"2026-04-15T09:00:00Z","tags":"dev"}}}'

# Create a recurring event with reminders and attendees
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":12,"method":"tools/call",
       "params":{"name":"create_event","arguments":{"title":"Team standup","start_at":"2026-04-12T10:00:00Z","reminder_minutes":"15","attendees":"Katie,John","recurrence_rule":"FREQ=DAILY;BYDAY=MO,TU,WE,TH,FR","tags":"meeting"}}}'

# Complete a task
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":13,"method":"tools/call",
       "params":{"name":"complete_task","arguments":{"task_id":"<task-uuid>"}}}'

成功した応答はこのようになります:

{
  "jsonrpc": "2.0",
  "id": 10,
  "result": {
    "content": [{"type": "text", "text": "{\"id\":\"...\",\"title\":\"Review PR\",\"status\":\"todo\"}"}]
  }
}
注記

書き込みおよび更新ツールはid、title、statusのみの最小限の応答を返します。書き込み後に完全な詳細(タグ、優先度、期限など)を取得するには、get_tasksまたはget_noteのようなフォローアップ読み取り呼び出しを行ってください。

トークンの管理​

アクション方法
トークンを表示iPhoneの設定 → 連携 → AIエージェント(またはウェブの設定 → AIエージェント)、目玉アイコンをタップ
トークンをコピートークンの隣のコピーアイコンをタップ
再生成再生成をタップして確認。古いトークンはすぐに動作しなくなり、アクティブなセッションは切断されます
モード変更Ultraのみ - 読み取り専用と読み取り+書き込みを切り替え。Proではモードは読み取り+書き込みで固定
無効化無効化をタップして確認。トークンは削除され、すべての接続が止まります。後で再有効化できます(新しいトークンが発行されます)

AIエージェントに何を頼めるか​

接続されたら、AIツールにこのようなことを尋ねてください:

1日の振り返り:

  • 「今日は何に取り組んだ?」
  • 「今週のノートを見せて」
  • 「期限切れのタスクは何?」

タスクの管理:

  • 「タスクを作成: 四半期レポートをレビュー、高優先度、金曜期限」
  • 「Figmaタスクを完了済みにマーク」
  • 「どのタスクに取り組んでいる?」

検索と分析:

  • 「マーケティング戦略に関するノートをすべて見つけて」
  • 「来週のイベントは?」
  • 「先週の日次レポートを要約して」

先を計画:

  • 「イベントを作成: 明日午前10時にチームスタンドアップ」
  • 「今週のカレンダーは?」
  • 「トップタグを見せて - 何にもっとも時間を使ってる?」

AIエージェントはノート、タスク、イベント、レポートに完全アクセスできます。データの読み取り、作成、更新、削除ができ、複数のツールからの情報を組み合わせて複雑な質問に答えられます。

重要な注意​

  • ノート作成の2つの方法 - create_noteはプレーンテキストノートを即座に作成します(AI分析なし)。process_noteは完全なAIパイプラインを実行します(アプリで録音するのと同じ) - テキストを分析し、タスクとイベントを抽出し、タグと埋め込みを生成します。TellDoneに考えてほしいときはprocess_noteを使ってください。
  • 連携の同期なし - MCP経由で作成または更新された項目はWebhook自動化や連携同期(Todoist、Notion)をトリガーしません。次の同期でアプリに表示されます。
  • セマンティック検索はツールに依存 - process_noteで作成されたノートは埋め込みを取得し、セマンティック検索に表示されます。create_noteで作成されたノートは埋め込みを取得しないので、テキスト検索にのみ表示されます。
  • 書き込み応答は最小限 - 作成および更新ツールはid、title、statusのみを返します。書き込み後にすべてのフィールドを取得するには、フォローアップの読み取り呼び出しを行ってください。
  • 日付フィルターはUTCを使用 - date_from/date_toパラメーターはUTCタイムスタンプとして比較されます。UTC以外のタイムゾーンのユーザーでは、境界の日付が隣接する日々の項目を含めたり除外したりする可能性があります。
  • レート制限 - 1秒あたり5リクエスト。一括操作ではリクエストのペースを調整してください。

セキュリティ​

  • 各ユーザーは一意の384ビット接続トークンを取得します
  • MCPを無効化または再生成すると、トークンはすぐに失効します
  • すべてのデータはアカウントに厳密に分離されます。エージェントは自分のデータにのみアクセスできます
  • すべてのリクエストはユーザーにスコープされます。エージェントが別のユーザーのデータにアクセスする方法はありません
  • 接続はレート制限(5 req/s)付きHTTPSを使います

関連項目​

に最終更新