MonicaをほかのAI・サービスとつなぐ：公式API、Botsのカスタムスキル、メッセージアプリ、Monica Codeを、設定する画面と渡るデータまで順に

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。運営者は Monica を入れていますが、使い心地はこの記事には書いていません。手順は「公式の手順を順に並べたもの」です。設定例は「公式の例の写し」か、「公式の記載に合わせて、この記事で組んだ例（動作は確かめていません）」のどちらかを、そのつど書き分けます。公式ページは要約の形で取得したため、コマンドや設定の全文は、必ず公式ページの原文で確かめてください。画面の表記は変わります。手元の画面と照らして読んでください。

先に結論

• プログラムからMonicaのモデルを呼ぶ → 公式API。 OpenAI互換とされ、公式のSDKの例は、ベースURLをMonicaのものに置き換える形です。アプリのプランとは別の残高が要ります。
• Monicaの中から、自分のサービスを呼ばせる → Botsのカスタムスキル。 OpenAPI形式のスキーマで書き、認証はAPI Keyだけです。
• 日常のチャットを、メッセージアプリへ → QRコードの連携。 手順は3段だけで、データの扱いと外し方は書かれていません。
• コードエディタの中で使う → Monica Code。 VS CodeとJetBrains向けです。手順の細部は、読んだページに書かれていません。
• 複数のAIの答えを、Monicaの中で見比べる → Model Response Comparison。 別のツールとの連携ではなく、Monica内の機能です。
• MCP・公式SDK・CLIの記載は、見つからなかった。 読んだ範囲（ヘルプの目次、APIのドキュメント、Botsの記事）にありませんでした。
• データの行き先は、つなぎ方ごとに違い、公式の記載の量も違う。 後の表にまとめます。

前提：用語をそろえる

• API。 プログラムからAIを呼び出す口です。画面を使わず、文章を送って答えを受け取ります。
• OpenAI互換。 OpenAIのAPIと同じ形で呼べる、という意味です。公式は、ベースURL（接続先の住所）を差し替えて使う例を載せています。
• ベースURL。 プログラムが接続する先の、共通の頭の部分のアドレスです。
• APIキー。 プログラムがAPIを使うための合言葉です。人に見せません。
• Bearerトークン。 Authorization: Bearer ... のヘッダーで送る合言葉です。Monicaの公式の例では、トークンにAPIキーを入れます。
• OpenAPI。 Web APIの仕様を書くための共通の書式です。OpenAIという会社名とは別のものです。
• スキーマ（Schema）。 ここでは、呼ばせたいAPIの形（住所、入力、出力）を書いたものです。
• SDK。 サービスをプログラムから呼びやすくする部品のセットです。この記事では、OpenAIのSDKを指します。
• MCP。 AIのツールが外のサービスにつながるための共通の規格です。
• 残高（funds）。 APIは、サブスクではなく、前払いの残高から使った分が引かれる仕組みです。

連携の一覧

つなぎ方1：公式API（Monica API Platform）

何ができるか

• チャット補完のAPIで、複数のモデルとプロバイダーを、OpenAI互換の形で呼びます。エンドポイントは POST https://openapi.monica.im/v1/chat/completions です。
• 認証は、ヘッダー Authorization: Bearer <token> です。tokenにはAPIキーを入れます（公式の例は $YOUR_API_KEY）。
• リクエストは、model と messages を持つJSONです。content は、{"type": "text", "text": "..."} と {"type": "image_url", "image_url": {"url": "..."}} の部品を並べた配列、という形が文書に出ます。
• stream などの他のパラメータ、レスポンスの形、エラーの一覧は、そのページに書かれていません。公式は「OpenAIのAPIの文書を見るように」と案内しています。
• 使える model の名前は、公式の「Models and pricing」のページにあります。この記事では、そのページを読んでいません。例では、公式の例にある gpt-4o だけを使います。

手順：アカウントと鍵を用意する

公式のクイックスタートの順序です。

1. Monicaのアカウントを作ります。クイックスタートには「Click here to sign up」のリンクがありますが、リンク先が空で、取得できませんでした。サインアップの入口のURLは、この記事では確認できていません。
2. 請求のページ（Billing）で、支払い方法を結び、残高を足します。クイックスタートは、APIを使うには残高がプラスである必要がある、と書いています。請求のページのリンク先も、取得できませんでした。
3. APIキーのページで、キーを作ります。「このキーはAPIの認証に使うので、漏らさないように保管すること」という趣旨が書かれています。リンク先は取得できませんでした。

4. 最初の呼び出しを送ります（次の手順）。

5. 請求書のダウンロードは請求のページ、利用の記録は利用状況のページ（Usage Page）で見る、とFAQにあります。

6. 支払い方法を結べない、残高を足せないときは、サポートに連絡する、と書かれています。

手順：curlで1回呼ぶ

下は、公式のクイックスタートの例に沿ったものです。取得は要約を経由しているため、記号や改行が原文と同じかどうかは、公式ページの原文で確かめてください。

curl https://openapi.monica.im/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -d '{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Hi!"
        }
      ]
    }
  ]
}'

1. ターミナル（コマンドを打つ画面）を開きます。
2. $YOUR_API_KEY を、APIキーに置き換えます。キーを、コマンドの履歴や共有する画面に残さないようにします（これはこの記事の注意です）。
3. コマンドを実行します。期待される結果は、公式の文書では、OpenAI互換の形の返答です。レスポンスの具体的な形は、公式のページに書かれていません。

手順：OpenAIのSDKから呼ぶ（TypeScript）

公式のチャットの文書には、OpenAIのSDKで baseURL を https://openapi.monica.im/v1 にし、apiKey を設定し、openai.chat.completions.create で gpt-4o に、文字と画像のURLを入れたメッセージを送り、最初の候補のメッセージを表示する例が載っています。文書の例は、apiKey が引用符なしの変数の書き方になっている、と取得の結果にありました。そのため、そのまま写さず、次の例は、公式の記載に合わせて、この記事で組んだ例です（動作は確かめていません）。

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://openapi.monica.im/v1",
  apiKey: process.env.MONICA_API_KEY,
});

const completion = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [
    { role: "user", content: [{ type: "text", text: "Hi!" }] },
  ],
});

console.log(completion.choices[0].message);

• MONICA_API_KEY は、この記事で付けた環境変数の名前です。公式の名前ではありません。
• 公式のチャットの文書は、タブの名前に「Python」があるのに、Pythonのコードは載っていない、と取得の結果にありました。Pythonの例は、公式にありません。

この記事の案：Pythonで書くとき

OpenAIのPython用SDKは、一般に、base_url と api_key を指定してクライアントを作ります。次の例は、その一般的な書き方に、Monicaの公式のベースURLを当てはめた、この記事の案です。Monicaの公式の例ではなく、動作は確かめていません。

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://openapi.monica.im/v1",
    api_key=os.environ["MONICA_API_KEY"],
)

res = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": [{"type": "text", "text": "Hi!"}]}],
)
print(res.choices[0].message)

渡るデータ、料金、制限

• レート制限。 FAQには数字がなく、別のページ（Rate limits）を案内しています。この記事では、そのページを読んでいません。
• 料金表。 チャットはトークン、画像は1枚ごとの課金、という説明は、03に書きました。数字は、今回は読んでいないため書きません。公式の「Models and pricing」で確かめてください。

外し方

• APIキーの削除（失効）や、残高の扱いについて、読んだページには手順が見つかりませんでした。APIキーのページ（リンク先が取得できなかったページ）の画面で確かめます。
• 残高の返金は、対応していない、と公式のFAQが書いています。
• プログラム側の対処として、鍵を使っている設定を外し、鍵の入った環境変数やファイルを消すことは、いつでもできます（これはこの記事の案で、公式の記載ではありません）。

うまくいかないときの確認点

つなぎ方2：Botsの Custom Skills（Monicaから自分のAPIを呼ぶ）

何ができるか

• Botsで作る自分用の助手に、自分のAPIを「スキル」として足せます。ヘルプは、スキルの説明が正確だと、ボットがスキルを正しく呼ぶ確率が上がる、と書いています。
• Built-in Skillsは、30種類以上（推論、画像・書類の読み取り、ウェブアクセス、DALL·E 3の描画など）とBots記事にあります。

手順：スキルを作ってボットに足す

ヘルプ「Custom Skills」と「Bots の Introduction」の順序です。

1. ボットの作成の画面で、「Add Skill」を押し、「+ Create」を押します。ボットの作り方（「+ Create Bot」など）は、06の場面11を参照してください。
2. 名前と説明を入れます。
3. 必要なら、Authを設定します。公式の記載では、現在は API Key だけが使え、「Auth Type」で、Headerを変えられます。既定のヘッダー名や、ほかの置き場所があるかは、ページに書かれていません。
4. 「Schema」の欄に、OpenAPI形式のJSONを入れます。公式は、「Skill Schema Generator」（monica.im/home/chat/skill-schema-generator/…）というページと、OpenAPIの標準（openapis.org）を参考に挙げています。
5. 「Create」を押します。
6. 「My Skill」のページで、作ったスキルを足します。
7. 「Test」を押して試します。思いどおりでなければ「Edit」で直します。
8. 別のボットで使うときは、そのボットの編集ページで足します。

設定例について

• 公式のCustom Skillsのページには、OpenAPIのJSONの例が載っていません。そのため、この記事は、スキーマの全文の例を、公式の写しとしては書けません。
• 書き方は、OpenAPIの標準（openapis.org）と、公式の「Skill Schema Generator」で確かめてください。入れる中身は、呼ばせたいAPIの住所、受け取る入力、返す出力です。
• 認証の鍵は、スキルのAuthの欄に入れます。鍵をスキーマの本文に書き込むかどうかは、公式の記載がありません。

渡るデータ

• 公式の記載。 Custom Skillsで、会話の内容のどの部分が、設定したAPIに送られるかは、ページに書かれていません（取得結果は「Not described」）。
• この記事の見立て。 スキルを使うと、ボットの会話の一部が、あなたの指定したAPIの受け手に届く仕組みだと考えられます。受け手がどこにあり、誰が管理するかは、設定する人の責任になります。公式のヘルプに、この点の注意書きは見つかっていません。
• 公開範囲との関係。 ボットの公開範囲は、Just Me、Link Sharing Only、Everyoneの3つです（Bots の Introduction）。スキルつきのボットを共有したとき、スキルの設定（鍵を含む）が見えるのかどうかは、ページに書かれていません。共有の前に、公式の画面の案内で確かめます。

外し方

• スキルを直すのは「Edit」と書かれています。ボットからスキルを外す手順、スキルを削除する手順は、読んだページに見つかりませんでした。
• Authに入れた鍵は、あなたのAPI側で、止めたり作り直したりできるようにしておく、という案は、この記事の案です。公式の記載ではありません。

うまくいかないときの確認点

つなぎ方3：メッセージアプリ（WhatsApp、Messenger、Line、Telegram）

手順

ヘルプ「Chat on WhatsApp & More」の順序です。

1. monica.im/im-integration（Multi-Platform Chat binding page）を開きます。ヘルプの「Start Multi-Platform Chat Now」も同じページに進みます。
2. WhatsApp、Messenger、Line、Telegramから、使うプラットフォームを選びます。
3. そのチャットアプリをスマホで開き、画面のQRコードを読み取ります。

書かれていないこと

• 連携のページを取得した結果は、タイトルと説明文だけで、本文が空でした。画面上の細かな手順は、この記事では確認できていません。
• 連携を外す方法、使える量の上限、必要なプラン、会話の保存と扱いは、ヘルプに書かれていません。ヘルプには「Upgrade Subscription to Unlock Full Features」のリンクがあるだけで、どの機能がどのプランかは書かれていません。
• この記事の見立てとして、会話は、そのメッセージアプリの運営会社と、Monicaの両方を通ると考えられます。公式の説明は見つかっていません。

確認点

つなぎ方4：Gmail・Outlook・YouTube・SNS・検索エンジン（拡張の連携）

ヘルプ「Multi-Platform Integration」の記載です。設定の手順はありません。拡張を入れると、次の場面で機能が加わる、という説明のページです。各セクションの案内は、拡張のストアのページへのリンクです。

• 渡るデータ。ページには書かれていません。ストアの掲載には、開発元の開示として、個人を特定できる情報、金融と決済の情報、個人間の通信、利用者の活動が挙げられています（05を参照）。メールを開いて要約する機能は、メールの本文を扱うことになると考えられます（この記事の見立て）。
• 外し方。ページには書かれていません。ブラウザの拡張の管理画面（「Manage Extensions」は、更新の手順の中で出てきます）で、拡張をオフにする操作が考えられますが、削除やオフの手順は公式のヘルプでは確認できていません。
• 設定のオンとオフ。ページには、機能ごとに切り替える設定は書かれていません。

つなぎ方5：Monica Code（VS Code、JetBrains）

公式ページ（monica.im/en/code）の記載です。

• 入口。 「Add to VSCode」と「Add to JetBrains」のボタン、「Log In」のリンク。ボタンのリンク先は、取得できませんでした。設定の手順は、ページに書かれていません。
• 機能。 コード補完（カーソル位置とコメントから）、プロンプトでの選択部分の編集、アクティブなファイルや索引化したコードベースとの対話、スクリーンショットを送ってのデバッグ、複数ファイルを作る・直すComposer。20以上の言語。
• モデル。 ページの見出しとFAQは「GPT-4oとClaude 3.5 Sonnet」と書いています。新しいモデルの扱いは、読んだページには書かれていません。
• 量。 コード補完以外のAI機能は、Advanced Queriesを使います。Freeは1日に8回の「Slow Advanced Queries」（0時に戻る）、Premiumは1か月に500回の「Fast Advanced Queries」（毎月1日に戻る）で、使い切ったあとは Slow が無制限です。
• 生成物。 ページは、生成したコードは利用者のもので、商用を含めて自由に使える、という趣旨を書いています。
• 更新履歴。 ヘルプのMonica Codeの欄にあるのは、V1.3.0だけです。ウェブ検索、複数形式のファイル添付、更新センター、画面の整理、システムプロンプトの改善などが書かれています。
• 渡るデータ。 送ったコードがどこへ渡るかは、そのページに書かれていません。プライバシーポリシーの扱いは、01・04を参照してください。
• 外し方。 記載が見つかりません。エディタ側の拡張の管理で外す方法が考えられますが、公式の手順は確認できていません。

つなぎ方6：Monicaの中で、複数のAIを見比べる

別のツールとつなぐのではなく、Monica内で複数のモデルの答えを並べる機能です。06の場面12にも、同じ手順を書きました。

1. monica.im で会話を始め、返答が終わるのを待ちます。
2. 「Get answers from other models」を押します。
3. 比べるモデルを選ぶか、全部を選びます。
4. モデルごとの返答を見比べます。

5. ボタンが見えないときは、「Settings > General > Chat」でオンにします。

6. ヘルプの例のモデルは、Claude 3.5 Sonnet、GPT-4o、Gemini 1.5 Pro、Llama 3.1 405B、Grok Betaの5つで、古い名前を含む可能性があります。

7. 翻訳には、ウェブ版の翻訳のページで、Google Translate、Microsoft Translate、GPT-4o、Claude 3.5、Gemini 1.5の結果を比べる機能があります（ヘルプ「Translate」）。
8. 渡るデータは、選んだモデルの提供会社です。どの会社に何が渡るかは、01・04を参照してください。

つなぎ方7：MCP、公式SDK、CLI、メール連携

• 読んだページの範囲（ヘルプの目次、Bots、Multi-Platform Integration、APIのクイックスタート、チャットのAPI、FAQ、Monica Code）には、MCPのサーバーや、公式のSDK、コマンドラインのツールの記載が見つかりませんでした。
• メールの連携は、つなぎ方4のGmailとOutlookの拡張の機能として出ます。メールを外部のアプリと自動でやりとりする、といった仕組みの記載は、見つかっていません。
• 「Monica」と同じ名前の別製品（monicahq.com）の資料や、「MonicaのMCP」を名乗る第三者の紹介を見かけても、この記事では根拠にしていません。何のMonica向けかを、公式の資料で確かめてください。
• 公式の資料に書かれていないものは、この記事では手順にしません。

渡るデータの行き先（まとめ）

この記事の案：つなぎ方の組み合わせ

ここから、この記事の案です。公式が示した組み合わせではなく、動作は確かめていません。

• 案1：自分のプログラムに、Monicaのモデルを足す。 すでにOpenAIのSDKで書かれたプログラムがあるとき、ベースURLとキーの置き場を、Monicaのものに変えられる可能性があります。公式の例はこの形ですが、既存のプログラムが使う機能（stream など）が、Monicaのページに書かれていないので、小さな呼び出しで確かめてから広げます。
• 案2：Monicaのボットから、自作のAPIを呼ぶ。 自分で管理するAPIの先に、別のAIや社内のデータを置くと、ボットの会話から呼べる可能性があります。何が送られるかは公式に書かれていないため、まず機密のない内容だけで、「Test」で確かめます。
• 案3：複数のAIの答えを見比べる。 Monicaの中のModel Response Comparisonで、複数のモデルの答えを並べる。別のAIのアプリとの間では、文章をコピーして貼る形になります。
• 共通の注意。 鍵は、公開のリポジトリや画面共有に出さない。使う理由がなくなった鍵は、鍵を発行した側で止める（止め方が公式に見つからないときは、画面で確かめる）。

気をつけること

• この記事は、実際に使って確かめた記録ではありません。運営者は Monica を入れていますが、使い心地はこの記事には書いていません。設定例のうち、「この記事で組んだ例」「この記事の案」としたものは、動作を確かめていません。
• コマンドとコードは、公式の要約をもとにしています。全文の記号や改行が原文と同じかどうかは、公式ページで確かめてください。
• クイックスタートの「サインアップ」「請求」「APIキー」のリンク先は、取得できませんでした。URLの推測はしていません。
• APIの料金表、使えるモデルの一覧、レート制限のページは、この記事では読んでいません。数字は、公式のページでその日の表示を確かめてください。
• APIの残高は、返金に対応していない、と公式のFAQが書いています。少額から試す、とも書かれています。
• APIキーを、公開のリポジトリ、画面共有、チャットに貼らないでください。
• Custom Skillsで送る内容や、共有したボットでのスキルの設定の見え方は、公式に書かれていません。機密を入れる前に確かめてください。
• 公式のヘルプのうち、Chat、Model Response Comparison、Knowledge、Monica Codeのモデルの記載は、古いモデル名を含みます。いまの画面と違う場合があります。
• 内容は、AIモデルの提供会社にも渡る前提で扱ってください（01・04を参照）。
• MCPなど、公式の資料に見つからなかった連携は、第三者の情報で補っていません。

公式の資料では確認できていない点

• APIの利用規約、レスポンスの形、エラーの一覧、ストリーミングの対応、APIキーの削除の手順。
• クイックスタートの各リンク先（サインアップ、請求、APIキー、サポート）。
• Custom Skillsのスキーマの例、送られる内容、スキルの削除、共有したときのスキルの設定の見え方。
• メッセージアプリ連携の画面上の手順、外し方、プランの条件、データの扱い。
• Monica Codeの導入の画面の手順、最新の対応モデル、送ったコードの扱い。
• MCP、公式SDK、CLIの案内。

出典

• Quickstart（Monica API Platform、確認日 2026-10-25）
• Chat completion（Monica API Platform、日付の表示なし、確認日 2026-10-25）
• Frequently Asked Questions（Monica API Platform、確認日 2026-10-25）
• Introduction（Monicaヘルプ Bots、確認日 2026-10-25）
• Custom Skills（Monicaヘルプ Bots、確認日 2026-10-25）
• Chat on WhatsApp & More（Monicaヘルプ、確認日 2026-10-25）
• IM Integration（Monica公式サイト、本文は空でタイトルと説明のみ、確認日 2026-10-25）
• Multi-Platform Integration（Monicaヘルプ、確認日 2026-10-25）
• Monica Code（Monica公式サイト、確認日 2026-10-25）
• Changelog（Monicaヘルプ、Monica Code V1.3.0と目次、確認日 2026-10-25）
• Model Response Comparison（Monicaヘルプ、古いモデル名を含む、確認日 2026-10-25）
• Translate（Monicaヘルプ、確認日 2026-10-25）
• Monica Agent（Monicaヘルプ、確認日 2026-10-25）
• Monica Chrome拡張の掲載（Chromeウェブストア、確認日 2026-10-25）
• Quick Start（Monicaヘルプ、確認日 2026-10-25）