askacharge.com — EV charging network

askacharge.com MCP サーバー

AI エージェントがEV充電ポイントのネットワークを操作できるようにします。

askacharge.com は、電気自動車の充電向けのCSMS（充電ステーション管理システム）です。ハードウェア向けのOCPP 1.6Jおよび2.0.1、料金体系と請求、QRコードとRFIDによるドライバー決済、事業者間のOCPI 2.2ローミング、税務請求書に対応しています。このリポジトリでは、プラットフォームをあらゆるModel Context Protocolクライアントに公開するリモートMCPサーバーについて説明します。

インストールは不要です。ホスト型のエンドポイントです。

https://askacharge.com/askacharge/api/mcp

トランスポートは、HTTP POST上のJSON-RPC 2.0（streamable-http）です。受け付けるプロトコルバージョンは次のとおりです。 2025-06-18、2025-03-26、2024-11-05。GETは意図的に405を返します。SSEストリームはありません。

---

このサーバーの目的

充電ポイント事業者は、エージェントが直接回答できる質問への対応に日々追われています。今オフラインになっている充電器はどれか、先月のサイトXの収益はいくらか、この時間帯に充電する料金は十分安いか、応答しなくなった充電器を再起動する。 REST APIでも、これらは以前から可能でした。MCPを使えば、誰も先にインテグレーションを作成することなく、エージェントが利用できるようになります。価値があるのはプロトコルではなく、各ツールをどのような場合に使うべきか、誤った使い方をした場合に何が起きるかを説明することです。

認証

ヘッダーは1つだけです。ブランドのAPIキーは、パネルのAPI keysから作成できます。

Authorization: Bearer ask_live_...

X-Api-Key: ask_live_...も使用できます。

キーを設定すると、スコープによって表示されるツールが決まります。読み取り専用キーにはaskacharge_parar_cargaが表示されません。コマンドは個別に付与できます。commands:remote-startとcommands:remote-stopを持つキーには開始と停止が表示されますが、再起動（commands:reset）とファームウェアは表示されません。commands:writeを付与すると、引き続きすべてのコマンドが対象になります。1つのロケーションに制限されたキー（commands:reset@hotel-madrid）にはコマンドツールが表示されますが、別の場所にある充電器に対して実行すると403が返されます。キーは1つのブランドに属し、そのブランドのデータにのみアクセスできます。

25 個のツール

読み取り

ツール	確認できる内容
askacharge_listar_cargadores	すべての充電ポイントのOCPPステータス、場所、最終接続時刻
askacharge_ver_cargador	1 台の充電器の詳細：コネクター、出力、アクセスモード、ステータス
askacharge_estado_en_vivo	現在の状況：接続中の充電器、実行中のセッション、使用中の電力
askacharge_resumen	期間ごとのKPI — エネルギー、売上、純利益率、セッション、顧客
askacharge_listar_sesiones	エネルギー、売上、コストを含む充電セッション履歴
askacharge_listar_incidencias	充電器ごとの未解決の障害
askacharge_listar_tarifas	料金グループ：kWh 単位、時間単位、セッション単位、PVPC、または無料
askacharge_precio_pvpc_hoy	本日のスペインのPVPC電気料金（時間ごと）
askacharge_listar_clientes	料金プランと月間消費量を含むフリート顧客
askacharge_limites_de_potencia	場所ごとのkW上限と負荷分散方式
askacharge_traza_de_actividad	ブランドのAPIキーが行った操作：書き込みと拒否された試行
askacharge_estado_comando	起動したコマンドのjob_idごとの進行状況：acked（充電器が受け付け、実際の効果を待っている状態）、confirmed（効果が届いた状態 — セッションが開始した、リセット後に充電器が復帰したなど）、timeout、rejected、failed

OCPPコマンド — これらは物理ハードウェアに作用します。それぞれ、充電器の確認応答に加えて**job_idを返します**。実際の効果は後からOCPP経由で届いてジョブが完了するため、コマンドを繰り返すのではなく、askacharge_estado_comandoを確認してください（繰り返すとセッションが2つ開始したり、2回再起動したりします）。

ツール	動作
askacharge_arrancar_carga	リモート起動（OCPP RemoteStartTransaction）
askacharge_parar_carga	リモート停止（OCPP RemoteStopTransaction）— 実行中のセッションを停止します
askacharge_reiniciar_cargador	ソフトまたはハードで再起動（OCPP Reset）
askacharge_cambiar_disponibilidad	充電器を使用可能または使用不可に設定（OCPP ChangeAvailability）
askacharge_desbloquear_conector	固着したケーブルを解放（OCPP UnlockConnector）
askacharge_refrescar_estado	充電器にステータス／ハートビート／メーターを今すぐ送信するよう要求（OCPP TriggerMessage）
askacharge_diagnosticos	充電器に診断ファイルをアップロードするよう要求（OCPP GetDiagnostics）

書き込み

ツール	動作
askacharge_crear_cargador	充電ポイントを登録
askacharge_cargadores_simulados	サンドボックス：最大10台のシミュレーションOCPP充電器を追加します。1分以内に接続し、すべてのコマンドに応答します
askacharge_crear_tarifa	料金グループを作成（per_kwh、per_hour、per_session、pvpc_margin、free…）
askacharge_crear_cliente	フリート顧客を登録
askacharge_crear_tag_rfid	ブランドでRFIDタグを認証

その他の手段

ツール	動作
askacharge_llamar_api	同じ権限チェックのもとで、プラットフォームの463種類のAPI操作のいずれかを呼び出します

製品を再実装するものではありません

すべてのツールは同じキーを使ってaskacharge.com独自のREST APIを呼び出すため、同じスコープ、同じ監査ログ、同じレート制限、同じ冪等性処理が適用されます。APIで禁止されている操作をツールが実行できてしまう場合、それは機能ではなくサーバーのバグです。ログに記録されるのはラッパー自体ではなく、ラッパーが実行した具体的な操作です。

使用方法

Claude Code

claude mcp add --transport http askacharge https://askacharge.com/askacharge/api/mcp \
  --header "Authorization: Bearer ask_live_..."

JSON設定を受け付けるクライアント

{
  "mcpServers": {
    "askacharge": {
      "type": "http",
      "url": "https://askacharge.com/askacharge/api/mcp",
      "headers": { "Authorization": "Bearer ask_live_..." }
    }
  }
}

起動確認用の直接アクセス

curl -s -X POST https://askacharge.com/askacharge/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

この確認にキーは必要ありません。initialize、ping、tools/listは匿名で応答し、匿名のtools/listは25個のツールの全カタログを返します（公開情報であり、上の表に記載されています）。それ以外のすべての操作であるtools/callにはキーが必要で、キーがない場合はその旨を示すJSON-RPCエラー（-32001）が返されます。キーが設定されていても無効な場合はエラーとなり、匿名アクセスにはフォールバックしません。

キーの取得

askacharge.comでアカウントを作成します。30日間のトライアルがあり、カードは不要です。その後、パネルでAPI keysを選択します。料金は月額一律20ユーロで、充電器は無制限、セッションごとのソフトウェア手数料もありません。割合が適用される項目も含めた料金一覧は、askacharge.com/askacharge/en/pricing.htmlで確認できます。

制限事項について

• ツール名と説明はスペイン語です。 プラットフォームの最初の市場はスペインとバスク地方です。モデルは問題なく扱えますが、接続する前に知っておいてください。
• キーを場所で限定すると、操作できる対象は制限されますが、読み取れる対象は制限されません。 一覧には引き続きブランド全体が表示されます。これは仕様として文書化されており、見落としではありません。
• 独立したサンドボックスはありません。 影響を及ぼさずに試すには、トライアルモードでブランドを作成してください。
• SSEストリームはありません。 リクエスト／レスポンスのみです。

プラットフォームの内容と対象外の事項を、現在のアーキテクチャ上の制限も含めて詳しく説明したものは、askacharge.com/llms.txtにあります。

関連情報

• 技術ドキュメント · 英語版
• OpenAPI 3.1仕様
• askacharge Python SDK · ソース

---

スペイン語

askacharge.comのリモートMCP サーバーです。電気自動車充電器管理プラットフォーム（CSMS）で、OCPP 1.6J/2.0.1、OCPI 2.2ローミング、QRコード決済、税務請求（Verifactu、TicketBAI/Batuz）に対応しています。

エンドポイント：https://askacharge.com/askacharge/api/mcp。インストールは不要です。ブランドのAPIキーをAuthorization: Bearerで認証に使用します。そのキーのスコープによって、表示されるツールが決まります。読み取り専用キーでは充電停止ツールは表示されません。コマンドは個別に付与できます（commands:remote-startを付与し、commands:resetは付与しないなど）。場所で限定したキー（commands:reset@hotel-madrid）で別拠点の充電器を指定すると、403が返されます。各コマンドはjob_idを返し、askacharge_estado_comandoで実際に反映されたかどうかを確認できます。

ツールは25種類あり、充電器、ライブ状態、セッション、料金、PVPC、顧客、電力上限、OCPPコマンド、新規登録に対応しています。さらに、同じ権限管理でAPIの463操作を呼び出せるaskacharge_llamar_apiもあります。ビジネスロジックを再実装するものはありません。すべてはREST API本体に対して実行され、同じスコープ、同じトレース、同じ利用上限が適用されます。

アカウントとキー：askacharge.comで、カード不要の30日間トライアルを利用できます。料金はaskacharge.com/askacharge/precios.htmlをご覧ください。

ライセンス

MIT — LICENSEをご覧ください。

レジストリ

公式のMCP Registryにcom.askacharge/askachargeとして公開されており、askacharge.comドメインに対して認証されます。

curl -s "https://registry.modelcontextprotocol.io/v0/servers?search=askacharge"

関連項目

• awesome-ocpp — OCPPサーバー、ライブラリ、シミュレーター、ローミング関連リソースをまとめた厳選リストです。
• askacharge-python — 同じAPI向けのPython SDKです。
• CSMS比較 2026 — 公開料金とともに、11のプラットフォームの中でaskacharge.comがどのような位置付けにあるかを紹介しています。