<?php
/**
 * Setup instructions for AI apps.
 *
 * @package HandyMCP
 */

namespace HandyMCP\Admin;

defined( 'ABSPATH' ) || exit;

/**
 * How to connect each AI app, with a ready config where the app uses one.
 * {URL} is replaced with this site's server URL; YOUR_TOKEN stays for the
 * user to paste an access token into.
 */
final class Clients {

	/**
	 * All clients, grouped.
	 *
	 * @return array<string, array<string, mixed>> id => [name, group, steps[], code, file].
	 */
	public static function all(): array {
		$token = __( 'Create an access token under <strong>Access tokens</strong> and put it where the config says YOUR_TOKEN.', 'handymcp' );
		$env   = __( 'Create an access token under <strong>Access tokens</strong> and use it as the value of WP_MCP_TOKEN.', 'handymcp' );
		$chat  = __( 'Chat apps', 'handymcp' );
		$code  = __( 'Coding agents and IDEs', 'handymcp' );
		$agent = __( 'Agents and other apps', 'handymcp' );
		return array(
			'claude'        => array(
				'name'  => 'Claude',
				'group' => $chat,
				'steps' => array(
					__( 'In Claude (web, desktop or mobile) open <strong>Settings &rsaquo; Connectors</strong> and choose <strong>Add custom connector</strong>.', 'handymcp' ),
					__( 'Give it a name, paste the server URL and click <strong>Add</strong>. On Team and Enterprise plans an owner adds it first, then everyone clicks <strong>Connect</strong>.', 'handymcp' ),
					__( 'Sign in to this site on the page that opens, pick what Claude may do, and approve.', 'handymcp' ),
				),
			),
			'chatgpt'       => array(
				'name'  => 'ChatGPT',
				'group' => $chat,
				'steps' => array(
					__( 'In ChatGPT open <strong>Settings &rsaquo; Apps</strong> (or Security) and turn on <strong>Developer mode</strong>.', 'handymcp' ),
					__( 'Create an app, paste the server URL and choose <strong>OAuth</strong>.', 'handymcp' ),
					__( 'Sign in to this site and approve the access you want to give.', 'handymcp' ),
				),
			),
			'grok'          => array(
				'name'  => 'Grok (grok.com)',
				'group' => $chat,
				'steps' => array(
					__( 'Open <strong>grok.com/connectors</strong>, choose <strong>New Connector &rsaquo; Custom</strong> and paste the server URL.', 'handymcp' ),
					__( 'Sign in to this site and approve.', 'handymcp' ),
				),
			),
			'lechat'        => array(
				'name'  => 'Mistral Le Chat',
				'group' => $chat,
				'steps' => array(
					__( 'An admin opens <strong>Connectors &rsaquo; Add Connector &rsaquo; Custom MCP Connector</strong> and pastes the server URL.', 'handymcp' ),
					__( 'Choose OAuth and approve on this site, or choose HTTP Bearer and paste an access token.', 'handymcp' ),
				),
			),
			'perplexity'    => array(
				'name'  => 'Perplexity',
				'group' => $chat,
				'steps' => array(
					__( 'Where your plan offers custom connectors, open <strong>Settings &rsaquo; Connectors</strong>, add a custom connector and paste the server URL, then approve on this site.', 'handymcp' ),
					__( 'In the Perplexity Mac app you can instead add a local server that runs the bridge shown under "Any other app".', 'handymcp' ),
				),
			),
			'claude-code'   => array(
				'name'  => 'Claude Code',
				'group' => $code,
				'steps' => array(
					__( 'Run this in a terminal. Leave out the header line to sign in with OAuth instead (then run <code>/mcp</code> in Claude Code).', 'handymcp' ),
					$token,
				),
				'code'  => "claude mcp add --transport http wordpress {URL} \\\n  --header \"Authorization: Bearer YOUR_TOKEN\" --scope user",
				'file'  => __( 'Terminal', 'handymcp' ),
			),
			'codex'         => array(
				'name'  => 'OpenAI Codex',
				'group' => $code,
				'steps' => array(
					__( 'Add this to <code>~/.codex/config.toml</code> (CLI, IDE extension and desktop app share it) and set the environment variable <code>WP_MCP_TOKEN</code> to your token.', 'handymcp' ),
					__( 'Or skip the token and run <code>codex mcp login wordpress</code> to sign in with OAuth.', 'handymcp' ),
					$env,
				),
				'code'  => "[mcp_servers.wordpress]\nurl = \"{URL}\"\nbearer_token_env_var = \"WP_MCP_TOKEN\"",
				'file'  => '~/.codex/config.toml',
			),
			'cursor'        => array(
				'name'  => 'Cursor',
				'group' => $code,
				'steps' => array(
					__( 'Open <strong>Settings &rsaquo; MCP</strong> or edit <code>~/.cursor/mcp.json</code> (all projects) or <code>.cursor/mcp.json</code> (one project). Without the headers block Cursor signs in with OAuth.', 'handymcp' ),
					$token,
				),
				'code'  => "{\n  \"mcpServers\": {\n    \"wordpress\": {\n      \"url\": \"{URL}\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_TOKEN\" }\n    }\n  }\n}",
				'file'  => '~/.cursor/mcp.json',
			),
			'vscode'        => array(
				'name'  => 'VS Code and GitHub Copilot',
				'group' => $code,
				'steps' => array(
					__( 'Run <strong>MCP: Open User Configuration</strong> (or create <code>.vscode/mcp.json</code>) and add this. VS Code asks for the token once and stores it securely. Without headers it signs in with OAuth.', 'handymcp' ),
					$token,
				),
				'code'  => "{\n  \"inputs\": [\n    { \"type\": \"promptString\", \"id\": \"wp-token\", \"description\": \"WordPress MCP token\", \"password\": true }\n  ],\n  \"servers\": {\n    \"wordpress\": {\n      \"type\": \"http\",\n      \"url\": \"{URL}\",\n      \"headers\": { \"Authorization\": \"Bearer \${input:wp-token}\" }\n    }\n  }\n}",
				'file'  => 'mcp.json',
			),
			'windsurf'      => array(
				'name'  => 'Windsurf',
				'group' => $code,
				'steps' => array(
					__( 'Open <strong>Cascade &rsaquo; MCP servers &rsaquo; View raw config</strong> and add this.', 'handymcp' ),
					$token,
				),
				'code'  => "{\n  \"mcpServers\": {\n    \"wordpress\": {\n      \"serverUrl\": \"{URL}\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_TOKEN\" }\n    }\n  }\n}",
				'file'  => 'mcp_config.json',
			),
			'gemini'        => array(
				'name'  => 'Gemini CLI',
				'group' => $code,
				'steps' => array(
					__( 'Run this, or add the JSON below to <code>~/.gemini/settings.json</code>. Note the key is <code>httpUrl</code>. Without the header Gemini CLI signs in with OAuth (<code>/mcp auth wordpress</code>).', 'handymcp' ),
					$token,
				),
				'code'  => "gemini mcp add --transport http -H \"Authorization: Bearer YOUR_TOKEN\" --scope user wordpress {URL}\n\n{\n  \"mcpServers\": {\n    \"wordpress\": {\n      \"httpUrl\": \"{URL}\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_TOKEN\" }\n    }\n  }\n}",
				'file'  => '~/.gemini/settings.json',
			),
			'antigravity'   => array(
				'name'  => 'Google Antigravity',
				'group' => $code,
				'steps' => array(
					__( 'Open <strong>Settings &rsaquo; Customizations &rsaquo; Installed MCP Servers</strong> and edit the raw config, or <code>~/.gemini/config/mcp_config.json</code>. Without headers Antigravity signs in with OAuth.', 'handymcp' ),
					$token,
				),
				'code'  => "{\n  \"mcpServers\": {\n    \"wordpress\": {\n      \"serverUrl\": \"{URL}\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_TOKEN\" }\n    }\n  }\n}",
				'file'  => 'mcp_config.json',
			),
			'grok-build'    => array(
				'name'  => 'Grok Build (terminal)',
				'group' => $code,
				'steps' => array(
					__( 'Run this in a terminal. Grok Build also picks up servers from Claude Code and Cursor configs.', 'handymcp' ),
					$token,
				),
				'code'  => "grok mcp add --transport http wordpress {URL} \\\n  --header 'Authorization: Bearer YOUR_TOKEN'",
				'file'  => __( 'Terminal', 'handymcp' ),
			),
			'cline'         => array(
				'name'  => 'Cline',
				'group' => $code,
				'steps' => array(
					__( 'Open <strong>MCP Servers &rsaquo; Configure</strong> and add this. Keep <code>"type": "streamableHttp"</code>, otherwise Cline uses the old SSE transport.', 'handymcp' ),
					$token,
				),
				'code'  => "{\n  \"mcpServers\": {\n    \"wordpress\": {\n      \"type\": \"streamableHttp\",\n      \"url\": \"{URL}\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_TOKEN\" }\n    }\n  }\n}",
				'file'  => 'cline_mcp_settings.json',
			),
			'zed'           => array(
				'name'  => 'Zed',
				'group' => $code,
				'steps' => array(
					__( 'Run <strong>zed: open settings file</strong> and add this. Without headers Zed signs in with OAuth.', 'handymcp' ),
					$token,
				),
				'code'  => "\"context_servers\": {\n  \"wordpress\": {\n    \"url\": \"{URL}\",\n    \"headers\": { \"Authorization\": \"Bearer YOUR_TOKEN\" }\n  }\n}",
				'file'  => 'settings.json',
			),
			'jetbrains'     => array(
				'name'  => 'JetBrains Junie and AI Assistant',
				'group' => $code,
				'steps' => array(
					__( 'Junie: add this to <code>~/.junie/mcp/mcp.json</code>. AI Assistant (2025.3 or later): <strong>Settings &rsaquo; Tools &rsaquo; AI Assistant &rsaquo; Model Context Protocol</strong>, add a server as JSON.', 'handymcp' ),
					$token,
				),
				'code'  => "{\n  \"mcpServers\": {\n    \"wordpress\": {\n      \"url\": \"{URL}\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_TOKEN\" }\n    }\n  }\n}",
				'file'  => 'mcp.json',
			),
			'continue'      => array(
				'name'  => 'Continue',
				'group' => $code,
				'steps' => array(
					__( 'Add this to <code>~/.continue/config.yaml</code> and store the token as a Continue secret named WP_MCP_TOKEN.', 'handymcp' ),
					$env,
				),
				'code'  => "mcpServers:\n  - name: wordpress\n    type: streamable-http\n    url: {URL}\n    requestOptions:\n      headers:\n        Authorization: Bearer \${{ secrets.WP_MCP_TOKEN }}",
				'file'  => '~/.continue/config.yaml',
			),
			'openclaw'      => array(
				'name'  => 'OpenClaw',
				'group' => $agent,
				'steps' => array(
					__( 'Add this to <code>~/.openclaw/openclaw.json</code>, then check it with <code>openclaw mcp doctor wordpress --probe</code>. For OAuth use <code>auth: "oauth"</code> and <code>openclaw mcp login wordpress</code> instead of headers.', 'handymcp' ),
					$token,
				),
				'code'  => "{\n  mcp: {\n    servers: {\n      wordpress: {\n        url: \"{URL}\",\n        transport: \"streamable-http\",\n        headers: { Authorization: \"Bearer YOUR_TOKEN\" }\n      }\n    }\n  }\n}",
				'file'  => '~/.openclaw/openclaw.json',
			),
			'hermes'        => array(
				'name'  => 'Hermes Agent',
				'group' => $agent,
				'steps' => array(
					__( 'Add this to <code>~/.hermes/config.yaml</code> and put <code>WP_MCP_TOKEN=YOUR_TOKEN</code> in <code>~/.hermes/.env</code>. For OAuth use <code>auth: oauth</code> instead of headers.', 'handymcp' ),
					$env,
				),
				'code'  => "mcp_servers:\n  wordpress:\n    url: \"{URL}\"\n    headers:\n      Authorization: \"Bearer \${WP_MCP_TOKEN}\"",
				'file'  => '~/.hermes/config.yaml',
			),
			'goose'         => array(
				'name'  => 'Goose',
				'group' => $agent,
				'steps' => array(
					__( 'Run <code>goose configure</code> &rsaquo; Add Extension &rsaquo; Remote Extension (Streamable HTTP), or add this to <code>~/.config/goose/config.yaml</code>.', 'handymcp' ),
					$token,
				),
				'code'  => "extensions:\n  wordpress:\n    enabled: true\n    type: streamable_http\n    name: wordpress\n    uri: {URL}\n    headers:\n      Authorization: Bearer YOUR_TOKEN\n    timeout: 300",
				'file'  => '~/.config/goose/config.yaml',
			),
			'lmstudio'      => array(
				'name'  => 'LM Studio',
				'group' => $agent,
				'steps' => array(
					__( 'In the <strong>Program</strong> tab choose <strong>Edit mcp.json</strong> and add this.', 'handymcp' ),
					$token,
				),
				'code'  => "{\n  \"mcpServers\": {\n    \"wordpress\": {\n      \"url\": \"{URL}\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_TOKEN\" }\n    }\n  }\n}",
				'file'  => 'mcp.json',
			),
			'copilot-studio' => array(
				'name'  => 'Microsoft Copilot Studio',
				'group' => $agent,
				'steps' => array(
					__( 'In your agent open <strong>Tools &rsaquo; Add a tool &rsaquo; New tool &rsaquo; Model Context Protocol</strong> and paste the server URL.', 'handymcp' ),
					__( 'Choose OAuth 2.0 with dynamic discovery, or API key in a header named <code>X-MCP-Authorization</code> with your access token as the key.', 'handymcp' ),
				),
			),
			'claude-desktop' => array(
				'name'  => __( 'Any other app (local bridge)', 'handymcp' ),
				'group' => $agent,
				'steps' => array(
					__( 'For apps that only run local (stdio) servers, such as older Claude Desktop configs: add this server, which uses the mcp-remote bridge (needs Node.js).', 'handymcp' ),
					__( 'Leave out the header lines to sign in with OAuth in the browser instead.', 'handymcp' ),
					$token,
				),
				'code'  => "{\n  \"mcpServers\": {\n    \"wordpress\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"{URL}\", \"--header\", \"Authorization:\${AUTH_HEADER}\"],\n      \"env\": { \"AUTH_HEADER\": \"Bearer YOUR_TOKEN\" }\n    }\n  }\n}",
				'file'  => 'claude_desktop_config.json',
			),
		);
	}
}