Hjarni

Hjarni

あなたとChatGPT、ClaudeのためのMarkdownノート。
読んだり編集したりする同じノートを利用できる、公式のホスト型MCPサーバーです。

ウェブサイト · ドキュメント · ブログ

---

できること

Hjarniは、公式のホスト型MCPサーバー（https://hjarni.com/mcp）を備えたMarkdownノートアプリです。ブラウザー、またはHjarniのiPhone、iPad、Apple Silicon Mac、Androidアプリでノートを作成、編集できます。ChatGPT、Claude、または互換性のある別のMCPクライアントを接続して、保存した同じノートを検索、閲覧、作成、更新、整理できます。

フォルダー、タグ、Wikiリンク、指示を使って、プロジェクト概要、調査ノート、あるいはセカンドブレインをアシスタント間で最新の状態に保てます。保存した変更はノート履歴で確認し、以前の本文に戻したり、有効なノートを添付ファイルとともにMarkdown形式でエクスポートしたりできます。

サーバーはHjarniがホストするため、接続にローカルブリッジやDockerコンテナを実行する必要はありません。このリポジトリでは、そのホスト型サービスについて説明しています。設定方法とクライアントごとの制限については、クライアントの互換性をご覧ください。

ChatGPTとClaudeの間でクライアントのコンテキストを共有する

各クライアントの好み、合意した範囲、日付入りの決定事項、現在の状況、次のアクションを、1つのプロジェクト概要にまとめておきましょう。ChatGPTとClaudeは、Hjarniの公式ホスト型MCPサーバーを通じて、同じMarkdownノートを読み書きできます。

1. 以下の設定ガイドを使って、両方のアシスタントを同じHjarniアカウントに接続します。クライアントプロジェクトコンテキストのテンプレートから始めましょう。このテンプレートでは、プロジェクトのインデックスと、確認済みの事実を記入する空の概要が作成されます。クライアントとプロジェクトごとに、別々の概要を用意してください。
2. 下書きを作成する前に、該当するクライアントとプロジェクトを見つけ、現在の概要全文を読み、参照元のリンクを返すようアシスタントに依頼します。該当するノートが複数ある場合は、どれを使うか確認させてください。
3. まずチャットで更新案を作成します。内容を確認したら、ほかの事実や、決定事項の背景にある日付と理由を維持したまま、同じ概要に変更点だけを保存するようアシスタントに依頼します。ノートを開いて結果を確認してください。
4. もう一方のアシスタントとの新しいチャットで、作業を続ける前に更新済みの概要を取得するよう明示的に依頼します。変わっていない範囲と好みに加え、新しい状況と次のアクションが報告されることを確認してください。

接続すると保存済みのノートを利用できますが、ノートが必ず取得されることや、すべての会話やアシスタント固有の記憶がコピーされることは保証されません。クライアントコンテキストの実演動画では、架空の概要を両方のアシスタントが使う様子と、確認を繰り返すためのプロンプトを紹介しています。

確認、復元、エクスポート

ノートの履歴とゴミ箱では、保存された編集内容と記録された作成者またはAIクライアントを確認し、以前のノート本文と現在のテキストを比較して、以前の本文を新しいバージョンとして復元できます。復元すると、その後の編集も含めて本文全体が置き換わります。現在のタイトル、フォルダー、その他のフィールドは変更されません。同じ作成者による短時間の編集は、1つのリビジョンにまとめられることがあります。削除したノートとフォルダーは、アカウントの制限に従い、30日間ゴミ箱から復元できます。履歴では保存された変更を確認できますが、書き込み前の承認が必要かどうかは、アシスタントの接続と設定によって異なります。

エクスポートとデータの所有権では、フォルダーと添付ファイルを含むMarkdown ZIPとしてアクティブなノートをダウンロードする方法を説明しており、アカウントなしで確認できるサンプルZIPも含まれています。エクスポートはHjarniの機能であり、MCPツールではありません。標準のMarkdown ZIPには、アーカイブ済みおよびゴミ箱内のノート、リビジョン履歴、フォルダーの指示は含まれません。別のアプリでは、wikiリンクと添付ファイルのURLを更新する必要がある場合があります。個人のノート、個別のフォルダー、チームは、それぞれ別にエクスポートできます。

接続

エンドポイントは https://hjarni.com/mcp です。ChatGPTとClaudeでは、OAuthサインインを使用します。手動でコピーしたAPIトークンは不要です。Authorizationヘッダーに対応するクライアントでは、HjarniはフルアクセスAPIトークンと、制限付きのエージェントトークンにも対応しています。

Claude.ai / Claude Desktop / Claude mobile

HjarniはClaude Connectors Directoryに登録されています。掲載ページを開き、Connectをクリックしてサインインしてください。

または、URLを使って追加できます。

1. Customize > Connectorsを開き、カスタムWebコネクターを追加します。
2. URL https://hjarni.com/mcp を入力します。
3. OAuthサインインを選択し、コネクターの追加を完了してから、Hjarniにサインインします。

アカウントとワークスペースの要件については、HjarniのClaudeガイドとClaudeの最新のコネクター手順を参照してください。カスタムコネクターはClaude Freeでも利用でき、上限は1つです。TeamとEnterpriseでは、オーナーがワークスペースでの利用可否を管理します。

Claude Code

claude mcp add --transport http hjarni https://hjarni.com/mcp

すべてのプロジェクトで利用できるようにするには、--scope userを追加します。その後、Claude Code内で/mcpを実行してOAuthサインインを完了します。

ChatGPT

HjarniをChatGPTディレクトリページからインストールしてサインインしてください。利用可否と使い方については、ChatGPTのセットアップガイドを参照してください。

アカウントでカスタムMCPサーバーが許可されている場合は、URLから追加することもできます。

1. Pluginsを開き、**+**を選択してから、Add custom MCP serverを選択します。
2. 名前、サーバーURL https://hjarni.com/mcp、およびOAuth認証を入力します。
3. 接続の詳細を確認し、プラグインを作成してインストールした後、Hjarniにサインインします。
4. 新しいチャットで、@メニューからHjarniを選択し、保存したノートを探すよう依頼します。

カスタムサーバーの利用可否とワークスペースの管理設定は、ディレクトリのエントリーをインストールすることとは別です。アカウントで表示されるラベルが異なる場合は、OpenAIの最新のカスタムMCP手順に従ってください。

その他の MCP クライアント

クライアントには、Streamable HTTP と、OAuth 2.0 with PKCE または Authorization: Bearer YOUR_API_TOKEN のいずれかのサポート対象の認証方法が必要です。OAuth のディスカバリーは https://hjarni.com/.well-known/oauth-authorization-server、保護されたリソースのメタデータは https://hjarni.com/.well-known/oauth-protected-resource にあります。プロンプト、パネル、イベントなどの機能はクライアントによって異なります。

セットアップガイド：Cursor · Copilot · Copilot Studio · Perplexity · Raycast

アクセス権とエージェントトークン

OAuth サインイン接続では、接続した Hjarni アカウントのアクセス権が使用されます。これには、アカウントがアクセスを許可されているチームと共有ノートが含まれます。プロンプトでフォルダーを 1 つ指定したり、フォルダーの指示を追加したりしても、その接続のアクセス権は制限されません。

Claude Code や Cursor などの互換性のあるクライアントでは、Settings > Connections でエージェントトークンを作成し、スペースまたはフォルダーに対して アクセスなし、読み取り、または 書き込み を許可します。許可はツリーの下位に継承され、さらに下位で上書きできます。エージェントがユーザー自身のアクセス権を超えることはできません。各トークンには、履歴に表示される独自の指示と ID を設定できます。通常の OAuth 接続の代わりに、トークンを Bearer 認証情報として使用してください。

制限付きトークンでは、表示されるツールの一覧が絞り込まれ、アカウント全体を管理するツールやノートパネルを使用できません。ただし、プロフィールなど、アカウント全体に関する一部の情報と、トークンで無効にしていない場合はブレインの指示が引き続き公開されます。正確な制限については、エージェントトークンのリファレンスをご覧ください。プライバシーと権限では、アカウント、チーム、接続のアクセス権について説明しています。

利用可能なツール

この表では、アシスタント向けのツールについて説明します。実際に利用できるかどうかは、接続の権限とクライアントにキャッシュされたツール一覧によって異なります。サーバーを更新した後は、クライアントで再接続するか、サーバーを更新してください。

ツール	説明
me	接続中のプロフィール、チーム、ノートの上限、オンボーディングの状態を確認します。制限付きトークンの場合、アカウント全体の上限とオンボーディング情報の代わりに、そのトークンに付与された権限を返します
dashboard-get	アカウントの概要を表示します。件数、最近のノート、すべてのスペースにおける最近の変更を確認できます
search	ノート、コンテナ、タグを全文検索します
notes-list	コンテナやタグによる絞り込み、並べ替えを指定してノートを一覧表示します
notes-get	単一のノートを読み込みます。本文全体、タグ、リンク、バックリンク、ファイル、継承された AI 指示を確認できます
notes-create	タイトル、本文、要約、タグ、配置先のコンテナを指定して、新しいノートを作成します
notes-update	内容の編集または追記、Markdown セクションの置換または追記、ノートの移動、タグの変更、アーカイブ、お気に入りへの追加、検証済みとしてのマークを行います
notes-open	対応ホストでは編集可能なノートパネルを開き、それ以外のクライアントではノートデータを返します。ID を省略すると選択画面を開きます
notes-delete	ノートをゴミ箱に移動します（30 日間は復元できます）
notes-restore	ゴミ箱からノートを復元します
notes-history	ノートの変更履歴を読み込みます。各バージョンの作成者、作成日時、変更内容を確認できます
notes-revert	ノートの本文を以前のバージョンに戻します（新しい履歴が追加されるため、元に戻すこともできます）
containers-list	ノートの整理に使用するフォルダーを一覧表示します
containers-get	説明と AI 指示を含む単一のコンテナを取得します
containers-create	新しいフォルダーを作成します
containers-update	コンテナを更新します（名前変更、移動、説明の変更、アーカイブ）
containers-permissions	チームコンテナでチームメンバーのロールを設定または解除します
containers-delete	フォルダー、そのサブフォルダー、およびその中のノートをゴミ箱に移動します（30 日間は復元できます）
containers-restore	削除されたフォルダーと、それと一緒に削除されたすべての項目を復元します
tags-list	すべてのタグを一覧表示します
tags-create	新しいタグを作成します
tags-manage	タグの名前変更、統合、削除を行います
links-manage	ノート間の双方向リンクを作成または削除します
instructions-get	ブレイン、個人ルート、コンテナ、チームの各レベルに設定された AI 指示を読み込みます
instructions-update	アクセス権と所有者の権限に応じて、ブレイン、個人ルート、個人フォルダー、チームの指示を置換または追記します
files-attach	Base64 ファイルを個人用ノートに添付します
files-attach_from_url	公開 URL またはネイティブ ChatGPT ファイル参照を個人用ノートに添付します
files-create_upload_url	認可された個人用、チーム、または共有ノート向けに、一度限りのブラウザーアップロードリンクを生成します
files-check_upload	アップロードリンクの状態を確認します
files-get_download_url	一時的なログイン不要のダウンロード URL を取得します。有効な間は認証情報として扱ってください
files-remove	個人用ノートから添付ファイルを完全に削除します
email-addresses-list	メール取り込み用アドレスを一覧表示します
email-addresses-create	メール取り込み用アドレスを作成します。このアドレス宛てのメールは、アカウントが対象条件を満たす場合、ノートになります
teams-list	ユーザーがメンバーになっているすべてのチームを一覧表示します
teams-get	最近のノートなど、チームの詳細を取得します
teams-create	新しいチームを作成します
teams-invite	メールアドレスでチームメイトを招待するか、共有可能な参加リンクを取得します
feedback-submit	Hjarni に関するフィードバックをメンテナーに送信します
nudges-dismiss	ユーザーが辞退した製品の提案を非表示にします

編集する場合は、まず現在のノートを読み込み、本文全体の置換よりも対象を絞った編集を優先してください。古い書き込みを検出するには、lock_version を expected_lock_version として渡します。これは厳密なロックではありません。append_body のみを実行する呼び出しではこのチェックが省略され、バージョンが一致しなくても、ノートの最新の編集者が接続中のユーザーであり、その編集から 30 分以上経過していれば受け入れられます。成功を報告する前にツールの結果を確認してください。アクセス拒否や上限による拒否では、status を含む ok: false、またはエラーメッセージを含む error: true が返されることがあります。ツールと権限のリファレンスを参照してください。

組み込みプロンプト

プロンプトの検出に対応しているクライアント向けに、サーバーは MCP プロンプトも公開します。

プロンプト	説明
summarize_note	ノートを要約し、タグと関連リンクを提案します
weekly_review	最近のアクティビティを振り返り、整理方法の改善を提案します
research_topic	ナレッジベース内のトピックに関連する情報をすべて統合します

MCP Apps

MCP Apps（io.modelcontextprotocol/ui 拡張機能）に対応しているホストでは、files-create_upload_url によってインラインのドロップゾーンを表示でき、チャットからノートにファイルを直接アップロードできます。それ以外のクライアントには、通常のアップロードリンクが表示されます。

notes-open では、会話の横にノートピッカーとエディターを表示できます。Hjarni のパネル拡張機能に対応している ChatGPT ホストでは、パネルでノートへのメンションや、選択したテキストのコンテキストへの添付も利用できます。利用可否は、ホストと公開済み接続の現在のツールメタデータによって異なります。notes-panel と notes-search_mentions は、このインターフェースで使用するアプリ専用ツールです。アシスタントは notes-get で読み取り、notes-update で編集してください。

クライアントは resources/read と hjarni://notes/42 のような URI を使用して、保存済みノートをリソースとして読み取ることもできます。ただし、同じノートアクセスのチェックが適用されます。これらは保存済みノートのリソースであり、会話を自動的に同期するものではありません。

変更イベント

イベント拡張機能に対応しているクライアントは、note.created、note.updated、note.deleted（ゴミ箱に移動）を購読できます。Hjarni は検証済みの Webhook コールバックに通知を配信し、配信前にアクセス権を確認します。通知には変更されたノートが記載されます。クライアントは notes-get でその内容を取得します。

events/list、events/subscribe、events/unsubscribe はプロトコルメソッドであり、ツールではありません。配信は Webhook のみで、ポーリングとストリーム配信には対応していません。イベントだけで、接続済みのすべてのアシスタントがバックグラウンドで実行されるわけではありません。イベントのリファレンスとイベントトリガー型ワークフローをご覧ください。

使用例

リサーチアシスタント

「技術スタックについて、どのような決定をしたか教えてください」

Claude がノートを検索し、関連するノート間の Wiki リンクをたどって、複数の情報源から要約をまとめます。

クイックキャプチャ

「これを Projects フォルダーのノートとして保存し、タグを付けてください」

Claude が適切なコンテナーを見つけ、Markdown 形式でノートを作成し、タグを追加して、関連するノートにリンクします。

週次レビュー

「受信箱の整理を手伝ってください」

Claude に未分類のノートを一覧表示させ、フォルダー構成に基づいてそれぞれの保存先を提案させます。ノートを移動する前に、承認を待つようにしてください。

コンテキストを活用した執筆

「最近の会議メモを使って、プロジェクトの進捗報告を作成してください」

Claude が関連するノートを取得し、資料として使用します。

機能

• Markdown ノート：書式設定を完全にサポート
• Wiki リンク（[[id:Note Title]]）による相互参照
• フォルダー：フォルダーごとにカスタム AI 指示を設定可能
• 全文検索：すべてのコンテンツを検索
• ノート間の双方向リンク
• 分野を横断した分類に使えるタグ
• AI 指示：ブレイン、個人ルート、フォルダー、チーム、個別のエージェントトークンの各レベルで設定可能
• ノート履歴：改訂ごとの作成者（あなた、または使用した AI クライアント）を記録し、元に戻すことが可能
• ゴミ箱：ノートとフォルダーを30日以内なら復元可能
• すべてのプランでファイル添付に対応（Pro と Teams では無制限）
• メールによるキャプチャ：フォルダー専用のメールアドレスを設定可能（Pro）
• 公開共有：すべてのプランでノートとフォルダーの閲覧専用リンクを利用可能。有料プランではゲストによる編集にも対応
• エージェントトークン：スペースおよびフォルダーごとの読み取り／書き込み権限を強制
• 共有ナレッジベースとフォルダーごとのロールによるチームコラボレーション
• iPhone、iPad、Mac、Android アプリ
• カスタム連携向けのREST API
• データをいつでも Markdown 形式でエクスポート

MCP サーバーの詳細

エンドポイント	https://hjarni.com/mcp
トランスポート	JSON-RPC 2.0 を使用する Streamable HTTP
プロトコルのバージョン	initialize 経由で 2025-11-25、2025-06-18、2025-03-26、および 2024-11-05 に対応し、server/discover 経由で 2026-07-28 に対応します（サポートされているメソッドについてはリファレンスを参照してください）
認証	OAuth 2.0（PKCE）、フルアクセス API トークン、または Bearer 認証情報として使用する制限付きエージェントトークン
機能	ツール、プロンプト、ノートおよび UI リソース（MCP Apps）、Webhook イベント

プロトコルの詳細については、MCP サーバーのドキュメントを参照してください。

料金

プラン	料金	内容
Free	$0	個人用ノート 25 件、フォルダー、タグ、検索、MCP と API へのアクセス、閲覧専用の公開リンク、5 個のファイル添付で合計 20 MB
Pro	$12/mo or $120/yr	ノートとファイル添付が無制限、メール取り込み、一般公開での共有、2 人の共同作業者との共有
Teams	$20/seat/mo or $200/seat/yr	共有ナレッジベース、チーム向け MCP と API、メンバー管理、フォルダーごとのロール

MCP と API へのアクセスはすべてのプランに含まれますが、アカウントの上限、機能の利用条件、権限は引き続き適用されます。ChatGPT または Claude のサブスクリプションは別途必要です。料金は EUR と GBP でも確認できます。最新の料金と上限を確認してください。

リンク

• ウェブサイト
• ドキュメント
• はじめに
• MCP サーバーリファレンス
• REST API リファレンス
• Claude セットアップガイド
• ChatGPT セットアップガイド
• ブログ
• プライバシー
• 利用規約

サポート

メールで [email protected] までお問い合わせください。

---