AI neco の図書館

MCPでできること

MCPは、AIアプリと外部サービスをつなぐ仕組みです。ai-necoを接続すると、「要約に使えるプロンプトを探して」のように、会話の中で検索や操作を頼めます。無料プランを含む一般ユーザーも利用できます。

操作	一般ユーザー	管理者
プロンプト・公開ニュースの検索と閲覧	利用できます	利用できます
自分のプロンプトの投稿・編集・削除	読み書きキーで利用できます	読み書きキーで利用できます
未解決リクエスト候補の作成	読み書きキーで利用できます	読み書きキーで利用できます
未解決リクエストの一覧・採用・解決・却下	利用できません	一覧は読み取り、変更は読み書きキーが必要です

閲覧できるプロンプトの範囲は、APIキーを発行したアカウントの権限に従います。他人のプロンプトの編集・削除はできません。ニュースの投稿・編集・削除は、現在のMCPでは管理者も利用できません。

接続するまでの4ステップ

1. PCとAIアプリを準備する

CursorまたはClaude Codeが使えるPCに、Node.jsのLTS版をインストールしてください。ai-necoのMCPはPC上で起動するため、ローカルのMCPサーバーに対応したアプリで利用します。

2. ai-necoでAPIキーを発行する

ai-necoにログインし、ユーザーメニューの「MCP連携・APIキー」を開きます。キーに「Cursor用」などの名前を付けて、権限を選んで作成してください。

読み取り：検索や閲覧だけに使う場合。
読み書き：自分のプロンプトの投稿・編集・削除や、未解決リクエストの作成にも使う場合。

表示されたAPIキーとシークレットを保存します。シークレットは作成直後に一度だけ表示されます。

3. 設定をコピーして、アプリに追加する

下の設定例をコピーし、YOUR_API_KEYとYOUR_API_SECRETを発行した値に置き換えます。すでにほかのMCPを設定している場合は、既存のmcpServers内にai-necoの項目を追加してください。

MCP設定例

{
    "mcpServers": {
        "ai-neco": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-server-ai-neco"
            ],
            "env": {
                "AI_NECO_BASE_URL": "https://ai-neco.kuma-base.com/api",
                "AI_NECO_API_KEY": "YOUR_API_KEY",
                "AI_NECO_API_SECRET": "YOUR_API_SECRET"
            }
        }
    }
}

Cursor：ホームフォルダーの~/.cursor/mcp.jsonに保存します。
Claude Code：作業フォルダー直下の.mcp.jsonに保存します。

キーを入れた設定ファイルは公開・共有しないでください。Claude Codeの.mcp.jsonはGitの管理対象から除外してください。

4. 再起動して、接続を確認する

アプリを再起動し、MCPの設定画面でai-necoが接続されていることを確認します。Claude Codeでは/mcpで状態を確認できます。ツールの利用許可を求められたら、操作内容を確認して進めてください。

アプリ側の詳しい手順は、Cursorの公式ガイド・Claude Codeの公式ガイドを参照してください。

接続できたら、こう頼んでみよう

最初は、ai-necoを使うことを指定して検索を試すと分かりやすくなります。

「ai-necoで、議事録を要約するプロンプトを探して」
「ai-necoの公開ニュースから、画像生成に関する記事を探して」
「学校のお知らせを整理したい。ai-necoで役立つ方法を探して」

読み書きキーを設定している場合は、「この指示文をai-necoに非公開のプロンプトとして保存して」のような頼み方もできます。投稿するときは、保存する本文と公開範囲を確認してください。

未解決リクエストとは？

ai-necoで探しても十分な解決策が見つからなかった困りごとを、運営向けの候補として記録する機能です。たとえば「学校のプリントから予定だけ抜き出したい」という要望を、今後プロンプトを作る題材として残せます。

一般ユーザーは候補を登録でき、管理者が採用・解決済み・却下を判断します。同じ課題と判定された場合は件数を加算して、需要の把握に使います。

通常の検索だけでは自動登録されません。「見つからなければ未解決リクエストとして登録して」と頼み、AIが登録ツールや検索時の登録オプションを使った場合に保存されます。登録には読み書きキーが必要です。

困ったとき

接続できない・npxが見つからない

Node.jsをインストールしたあと、AIアプリを再起動してください。設定ファイルの場所、JSONのカンマや引用符、commandとargsが設定例と一致しているかも確認します。MCPの接続方式は、PC上のコマンドを実行する形式です。設定内のAPIのURLを、リモートMCPの接続URL欄に入れても接続できません。

APIキー・シークレットが無効と表示される（401）

設定例の仮の値を、発行したキーとシークレットに置き換えたか確認してください。別々のキーの組み合わせや削除済みのキーは使えません。修正後はMCPを再接続するか、アプリを再起動します。

検索はできるが、投稿できない（403）

読み取りキーでは投稿できません。「読み書き」を選んで新しいキーを発行し、設定を更新してください。読み書きキーでも、他人のプロンプトや管理者専用の操作は変更できません。

シークレットを紛失した・接続をやめたい

シークレットは再表示できません。MCP連携・APIキーから該当のキーを削除すると、そのキーでの接続が無効になります。使い続ける場合は、新しいキーを発行して設定を更新してください。

ほかに分からないことがある

お問い合わせから、利用しているアプリとエラー内容をお知らせください。APIキーやシークレットは送らないでください。