Clearly

Clearly

エージェントがアクセスできるワークスペース。 ドキュメント、キャンバス、スライド、スプレッドシート、プロジェクト、チケットに、任意のクライアントやターミナルから MCP 経由でアクセスできます。

• ウェブサイト — clearly.sh
• MCP ドキュメント — clearly.sh/docs/mcp
• MCP レジストリ — sh.clearly/clearly

このリポジトリにはソースコードはありません。 イシュー、リリースノート、セキュリティ報告のための公開スペースです。Clearly はホスト型サービスです。サーバーは当社のインフラ上で稼働し、CLI はビルド済みのものを配布しています。不具合を報告したり、リリースで何が変わったのかを尋ねたりする場所をお探しなら、ここで間違いありません。

---

MCP

Clearly はプラグインではなく MCP サーバーです。エージェントから接続します。 すでにリモートサービスとしてホストされているため、デプロイするローカルサーバーパッケージはありません。Glama では、Connect を使うか、以下の URL をコピーして OAuth サインインを完了してください。

https://relay.clearly.sh/mcp

認証には動的クライアント登録を伴う OAuth 2.1（RFC 7591）を使用するため、ほとんどのクライアントで必要なのは URL だけです。サインイン時に、接続先となる ワークスペースとエージェントを選択します。

Claude Code

claude mcp add --transport http clearly https://relay.clearly.sh/mcp
claude mcp login clearly

コネクターと一連のスキルをまとめた Claude Code プラグインもあります。

その他のクライアント

ストリーミング可能な HTTP MCP に対応するクライアントなら、どれでも同じ URL に接続できます。設定方法はクライアントによって異なります。Claude Desktop と Cursor は mcpServers を使用し、VS Code は "type": "http" を指定した servers を使用します。Codex は環境変数からベアラートークンを読み込みます。 MCP ドキュメントには、クライアントごとの設定例が記載されています。

複数のワークスペースやエージェントを同時に使う場合

クライアントが保存できるのはサーバーエントリごとに 1 つの認証情報のため、1 つのエントリで 2 つのワークスペースを使うと競合します。そのため、追加の URL パス形式が 2 つ用意されています。それぞれが独立した認証情報キーになります。

URL	意味
/mcp	サインイン時に選択したワークスペースとエージェント
/mcp/w/<workspaceId>	1 つのワークスペースに固定
/mcp/w/<workspaceId>/a/<agentId>	1 つのワークスペースと1 つのエージェントに固定

エージェントのセグメントはアドレス指定であり、権限を与えるものではありません。トークンに紐づくエージェントと一致しない場合、サーバーはリクエストを拒否します。

プロトコル

ストリーミング可能な HTTP です。最新のクライアントはステートレスな 2026-07-28 プロトコルを使用できます。レガシークライアントは initialize を通じて 2025-06-18、2025-03-26、または 2024-11-05 をネゴシエートできます。型付きツールは 7 つあり、clearly_catalog、clearly_read、clearly_write、clearly_edit、clearly_delete、clearly_grep、clearly_glob です。

serverInfo.version は、短いデプロイ ID を付加した MCP サーフェスのバージョンを <surface-version>+<deploy-id> の形式で報告します。サーフェスのバージョンは、ツールの契約が変更されたときに変わります。

---

CLI

curl -fsSL https://clearly.sh/install.sh | sh

インストーラーは beehaven を ~/.local/bin に書き込みます（BEEHAVEN_BIN_DIR で変更できます）。

実行前に内容を確認してください。install.sh は通常のシェルスクリプトです。シェルにパイプで渡す操作には注意が必要なため、動作を正確に説明します。このスクリプトは downloads.clearly.sh から HTTPS 経由でリリースの tarball をダウンロードし、その中で npm install を実行して、お使いのプラットフォーム向けにネイティブ依存関係（better-sqlite3、node-pty）をビルドします。現時点では署名もチェックサムも検証しません。信頼の根拠は TLS と当社です。Node 20 以降が必要で、スクリプトは最初にその要件を確認します。

beehaven login                       # authenticate
beehaven connect home                # pick a workspace
beehaven ls ~                        # your documents, as files
beehaven grep -ril pricing ~         # search them
beehaven call <action> '{...}'       # any workspace action
beehaven status                      # connection + auth state

残りの項目は beehaven --help に記載されています。

---

問題の報告

• バグと機能リクエスト — issue を作成する。
• セキュリティ — 公開 issue は作成しないでください。SECURITY.mdをご覧ください。

MCP の問題を報告する際は、beehaven status と、失敗した initialize の出力を含めると、特に役立ちます。サーバーはビルド情報を serverInfo.version (<surface-version>+<deploy-id>) で報告します。この情報から、対象のツールの契約とデプロイ済みビルドを特定できます。

---

ライセンス

このリポジトリの内容にはMITライセンスが適用されます。Clearly サービス自体には、利用規約が適用されます。