HELP

API キーと AI アシスタント(MCP)

外部のシステムや AI アシスタントから Halict を操作するための設定です。

API キーを発行する

設定メニューの「API キー」を開きます。

  1. 1

    「キーを発行」を押し、「キーの名前(用途がわかる名前)」を入力して「発行する」を押します。

  2. 2

    表示されたキーをコピーして安全な場所に保管します。キーはこのときだけ表示され、再表示はできません。

  3. 3

    API を呼ぶときは、Authorization ヘッダに Bearer に続けてキーを渡します。

  • 一覧には、キーの先頭の文字と「最終利用」の日時が出ます。
  • ごみ箱を押して「失効する」と、そのキーを使う連携は動かなくなります。
  • API の仕様は「API と Webhook」のページで公開しています。

AI アシスタントから使う(MCP)

「AI アシスタントから使う(MCP)」に表示される住所を AI アシスタントに追加すると、会話しながらフォームを作ったり、集まった回答を読んだりできます。

  • Claude: 設定の「コネクタ」で、カスタムコネクタとして住所を追加します。
  • ChatGPT: 設定で開発者モードをオンにし、アプリを作る画面で住所を入れ、認証に OAuth を選びます(有料プランで使えます)。
  • Claude Code: 画面に表示される1行のコマンドで追加し、/mcp からログインします。

追加すると Halict のログインと許可の画面が開き、許可したワークスペースだけに繋がります。AI からの接続は、キーの一覧に「AI の接続」として表示され、ほかのキーと同じように失効できます。ログインの画面を挟めない使い方では、発行したキーを Authorization ヘッダで渡します。

外部の道具からの購読

n8n などの道具が登録した通知先は、「外部の道具からの購読」に一覧で出ます。道具の側でワークフローを止めるとここからも消え、こちらから「解除」することもできます。

解決しないときや不具合に気づいたときは、お問い合わせのフォームからご連絡ください。2営業日以内にご返信します。