AI desktop integration

Codex / Claude + WiFi Lens

Turn a compatible desktop AI into a local Wi-Fi analyst. One setup prompt connects it to live scan data without sending anything to the cloud.

Local MCPRead-only todayNo cloud upload

Download WiFi Lens Technical guide

Open WiFi Lens and enable MCP

Start a scan, open Settings, turn on the MCP server, and confirm its port. The server stays on 127.0.0.1.

Send one setup prompt

Copy the prompt below into Codex Desktop or Claude Desktop. It asks the client to add only this local MCP entry and verify the tools.

Universal MCP setup prompt for Codex Desktop and Claude Desktop

Set up a local MCP server named "wifi-lens" for this client.

Transport: Streamable HTTP
URL: http://127.0.0.1:19840/
Purpose: Read-only access to local Wi-Fi scan data exposed by the WiFi Lens macOS app.

Requirements:
1. Add or update only the MCP server entry named "wifi-lens".
2. Preserve every other setting and MCP server.
3. Use this client's native configuration format.
   - For TOML-based clients, create/update:
     [mcp_servers.wifi-lens]
     url = "http://127.0.0.1:19840/"

   - For JSON-based clients, merge/update:
     {
       "mcpServers": {
         "wifi-lens": {
           "url": "http://127.0.0.1:19840/"
         }
       }
     }
4. Do not expose this server through LAN, tunneling, or public networking. It must stay bound to 127.0.0.1.
5. Do not install dependencies or modify unrelated settings.
6. After applying the configuration, verify that the wifi-lens MCP server is available and list its tools.
7. If you cannot modify the client configuration directly, return the exact minimal configuration snippet and the manual step required.

Two desktops, one target state

The same prompt describes the goal. Each client uses its own configuration format.

Manual fallback · TOML

Codex Desktop

Codex supports Streamable HTTP servers in ~/.codex/config.toml.

~/.codex/config.toml
[mcp_servers.wifi-lens]
url = "http://127.0.0.1:19840/"

Manual fallback · JSON

Claude Desktop

Claude Desktop uses an mcpServers JSON entry for Streamable HTTP servers.

{
  "mcpServers": {
    "wifi-lens": {
      "url": "http://127.0.0.1:19840/"
    }
  }
}

What the AI can inspect

Nearby networks

SSID, BSSID, RSSI, band, channel, PHY, security, and capability flags.

Channel occupancy

Network counts by channel and band to spot crowded spectrum.

One AP in focus

Look up a network by BSSID when the answer needs one device, not the whole list.

Local by default

MCP is off until you enable it. The server binds to 127.0.0.1, does not upload scans, and has no telemetry. Do not tunnel or forward it.

WiFi Lens is independent software. Codex and Claude are supported through the standard MCP interface, not through an official partnership.