Bonapara/twenty codex plugin (#20857)

@martmull v2.0 ;) --------- Co-authored-by: martmull <martmull@hotmail.fr> Co-authored-by: bosiraphael <raphael.bosi@gmail.com>
2026-06-02 16:39:14 +02:00
parent cb744b2eeb
commit 1642be86f5
52 changed files with 5151 additions and 0 deletions
@@ -0,0 +1,177 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+name=""
+url="${TWENTY_MCP_URL:-}"
+force_login="false"
+print_url="false"
+
+usage() {
+  cat <<'EOF'
+Usage: setup-mcp.sh [--name server-name] [--force-login] [--print-url] <workspace-url-or-mcp-url>
+
+Examples:
+  setup-mcp.sh acme.twenty.com
+  setup-mcp.sh --force-login https://crm.example.com
+  setup-mcp.sh --name twenty-local acme.localhost:3001
+  setup-mcp.sh --name twenty-prod https://crm.example.com/mcp
+
+OAuth:
+  Codex may open OAuth automatically after the server is added.
+  Use --force-login only if that does not happen.
+
+Environment:
+  TWENTY_MCP_URL   MCP URL to use when no URL argument is provided.
+EOF
+}
+
+normalize_url() {
+  local raw="$1"
+  raw="${raw#"${raw%%[![:space:]]*}"}"
+  raw="${raw%"${raw##*[![:space:]]}"}"
+  raw="${raw%/}"
+
+  if [[ "$raw" != http://* && "$raw" != https://* ]]; then
+    if [[ "$raw" == localhost* || "$raw" == 127.* || "$raw" == "[::1]"* || "$raw" == *.localhost || "$raw" == *.localhost:* ]]; then
+      raw="http://$raw"
+    else
+      raw="https://$raw"
+    fi
+  fi
+
+  if [[ "$raw" != */mcp ]]; then
+    raw="${raw%/}/mcp"
+  fi
+
+  echo "$raw"
+}
+
+derive_name() {
+  local normalized="$1"
+  local host="${normalized#http://}"
+  host="${host#https://}"
+  host="${host%%/*}"
+  host="${host#*@}"
+  host="${host#[}"
+  host="${host%]}"
+
+  local port=""
+  if [[ "$host" == *:* && "$host" != *:*:* ]]; then
+    port="${host##*:}"
+    host="${host%%:*}"
+  fi
+
+  local stem="$host"
+  if [[ "$stem" == *.twenty.com ]]; then
+    stem="${stem%.twenty.com}"
+  elif [[ "$stem" == *.* && "$stem" != localhost && "$stem" != *.localhost ]]; then
+    stem="${stem%.*}"
+  fi
+
+  if [[ -n "$port" ]]; then
+    stem="$stem-$port"
+  fi
+
+  stem="$(printf '%s' "$stem" | tr '[:upper:]' '[:lower:]' | sed -E 's/[^a-z0-9]+/-/g; s/^-+//; s/-+$//; s/-+/-/g')"
+
+  if [[ -z "$stem" ]]; then
+    echo "twenty"
+  else
+    echo "twenty-$stem"
+  fi
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --name)
+      name="${2:-}"
+      shift 2
+      ;;
+    --login)
+      echo "Warning: --login is deprecated and ignored. Codex starts OAuth during MCP setup when needed; use --force-login only as a manual fallback." >&2
+      shift
+      ;;
+    --force-login)
+      force_login="true"
+      shift
+      ;;
+    --print-url)
+      print_url="true"
+      shift
+      ;;
+    -h | --help)
+      usage
+      exit 0
+      ;;
+    --)
+      shift
+      url="${1:-$url}"
+      break
+      ;;
+    -*)
+      echo "Unknown option: $1" >&2
+      echo >&2
+      usage >&2
+      exit 1
+      ;;
+    *)
+      url="$1"
+      shift
+      ;;
+  esac
+done
+
+if [[ -z "$url" ]]; then
+  echo "A Twenty workspace URL is required, for example: https://crm.example.com" >&2
+  echo
+  usage
+  exit 1
+fi
+
+url="$(normalize_url "$url")"
+
+if [[ -z "$name" ]]; then
+  name="$(derive_name "$url")"
+fi
+
+if [[ "$print_url" == "true" ]]; then
+  echo "$url"
+  exit 0
+fi
+
+if ! command -v codex >/dev/null 2>&1; then
+  echo "The codex CLI is required but was not found in PATH." >&2
+  exit 1
+fi
+
+is_codex_managed_shell() {
+  [[ -n "${CODEX_THREAD_ID:-}" || "${CODEX_INTERNAL_ORIGINATOR_OVERRIDE:-}" == *"Codex"* ]]
+}
+
+if codex mcp get "$name" >/dev/null 2>&1; then
+  codex mcp remove "$name" >/dev/null
+fi
+
+codex mcp add "$name" --url "$url"
+
+echo "Configured Twenty MCP:"
+echo "  name: $name"
+echo "  url:  $url"
+echo
+
+if [[ "$force_login" == "true" ]]; then
+  if is_codex_managed_shell; then
+    echo "Skipped forced OAuth login because this helper is running inside Codex."
+    echo "Codex may open OAuth automatically after the MCP server is added."
+    echo
+    echo "If no OAuth window opens, run:"
+    echo "  codex mcp login $name"
+    exit 0
+  fi
+
+  codex mcp login "$name"
+else
+  echo "Next step:"
+  echo "  Codex may open OAuth automatically. If it does not, run:"
+  echo "  codex mcp login $name"
+fi