From 3539ed93638d83578ceb5de7555ac8794b499a8a Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 30 Jun 2026 07:15:39 +0000 Subject: [PATCH 1/2] docs: add changelog entry for MCP app-only Bearer support --- changelog.mdx | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/changelog.mdx b/changelog.mdx index 8ef5fb3e7..932d2791e 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -7,6 +7,19 @@ keywords: ["changelog", "API updates", "release notes", "what's new", "API chang To subscribe to updates, please [**“Turn on notifications”**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive) for [**@API**](https://x.com/api). + + ### New: app-only Bearer connection for the X MCP server + + You can now connect any MCP client to the hosted [X MCP server](/tools/mcp) using just your app's Bearer token as an `Authorization` header — no local bridge, no browser login. This is the fastest way to try the server from clients that support remote MCP with custom headers, and is well suited to read-only workflows (search, lookups, trends, news). + + Two getting-started routes are now documented side-by-side: + + - **Simple** — paste your app-only Bearer token into the client config. Read-only endpoints; no user context. + - **Full** — run the `xurl mcp` bridge for OAuth 2.0 user context. Required for writes (bookmarks, Articles) and any tool that acts as you. + + Each client section (Grok Build, Cursor, Claude Desktop, VS Code, and any other MCP client) shows both configuration snippets so you can pick the route that fits. + + ### Articles draft and publish endpoints From b998b888da335859021ec5cff24b22518c5eed69 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 30 Jun 2026 07:18:16 +0000 Subject: [PATCH 2/2] docs: translate MCP app-only Bearer changelog entry to ja/es/pt/ko --- es/changelog.mdx | 13 +++++++++++++ ja/changelog.mdx | 13 +++++++++++++ ko/changelog.mdx | 13 +++++++++++++ pt/changelog.mdx | 13 +++++++++++++ 4 files changed, 52 insertions(+) diff --git a/es/changelog.mdx b/es/changelog.mdx index 96daa5bb1..6fd5ccb4d 100644 --- a/es/changelog.mdx +++ b/es/changelog.mdx @@ -7,6 +7,19 @@ keywords: ["registro de cambios", "actualizaciones de la API", "notas de la vers Para suscribirte a las actualizaciones, [**"Activa las notificaciones"**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive) para [**@API**](https://x.com/api). + + ### Nuevo: conexión con Bearer solo de app para el servidor X MCP + + Ahora puedes conectar cualquier cliente MCP al [servidor X MCP](/tools/mcp) alojado usando solo el Bearer token de tu app como encabezado `Authorization`: sin bridge local ni inicio de sesión en el navegador. Es la forma más rápida de probar el servidor desde clientes que admiten MCP remoto con encabezados personalizados, y se adapta bien a flujos de solo lectura (búsqueda, lookups, trends y noticias). + + Ahora documentamos dos rutas de inicio en paralelo: + + - **Simple** — pega tu Bearer token de solo app en la configuración del cliente. Endpoints de solo lectura; sin contexto de usuario. + - **Completa** — ejecuta el bridge `xurl mcp` para obtener contexto de usuario con OAuth 2.0. Necesaria para escrituras (bookmarks, Articles) y cualquier herramienta que actúe en tu nombre. + + Cada sección de cliente (Grok Build, Cursor, Claude Desktop, VS Code y cualquier otro cliente MCP) muestra ambos snippets de configuración para que elijas la ruta que mejor te convenga. + + ### Endpoints de borrador y publicación de Articles diff --git a/ja/changelog.mdx b/ja/changelog.mdx index 2accc0329..5f15fdae8 100644 --- a/ja/changelog.mdx +++ b/ja/changelog.mdx @@ -7,6 +7,19 @@ keywords: ["変更履歴", "API 更新", "リリースノート", "新着情報" 更新情報の通知を受け取るには、[**@API**](https://x.com/api) の [**「通知をオンにする」**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive) を有効にしてください。 + + ### 新着: X MCP サーバーのアプリ専用 Bearer 接続 + + ホストされた [X MCP サーバー](/tools/mcp) に対して、アプリの Bearer トークンを `Authorization` ヘッダーとして渡すだけで、任意の MCP クライアントから接続できるようになりました。ローカルブリッジもブラウザログインも不要です。カスタムヘッダー付きのリモート MCP をサポートするクライアントからサーバーを最も手軽に試せる方法であり、読み取り専用のワークフロー（検索、ルックアップ、トレンド、ニュース）に適しています。 + + はじめにの 2 つのルートを並べて記載しました: + + - **シンプル** — アプリ専用 Bearer トークンをクライアント設定に貼り付けます。読み取り専用のエンドポイントのみで、ユーザーコンテキストはありません。 + - **フル** — OAuth 2.0 ユーザーコンテキスト用に `xurl mcp` ブリッジを実行します。書き込み（ブックマーク、Articles）や、ユーザーとして動作するツールに必須です。 + + 各クライアントセクション（Grok Build、Cursor、Claude Desktop、VS Code、その他の MCP クライアント）に両方の構成スニペットを掲載しているので、用途に合うルートを選べます。 + + ### Articles のドラフトおよび公開エンドポイント diff --git a/ko/changelog.mdx b/ko/changelog.mdx index 8a2e3c0b9..0237d9f2c 100644 --- a/ko/changelog.mdx +++ b/ko/changelog.mdx @@ -7,6 +7,19 @@ keywords: ["변경 로그", "API 업데이트", "릴리스 노트", "새로운 업데이트를 구독하려면 [**@API**](https://x.com/api)의 [**"알림 켜기"**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive)를 활성화하세요. + + ### 신규: X MCP 서버를 위한 앱 전용 Bearer 연결 + + 이제 호스팅된 [X MCP 서버](/tools/mcp)에 앱의 Bearer 토큰만 `Authorization` 헤더로 전달하여 어떤 MCP 클라이언트에서도 연결할 수 있습니다. 로컬 브리지나 브라우저 로그인이 필요하지 않습니다. 사용자 지정 헤더가 있는 원격 MCP를 지원하는 클라이언트에서 서버를 가장 빠르게 시험해 볼 수 있는 방법이며, 읽기 전용 워크플로(검색, 조회, 트렌드, 뉴스)에 적합합니다. + + 두 가지 시작 경로를 나란히 문서화했습니다: + + - **간단 경로** — 앱 전용 Bearer 토큰을 클라이언트 구성에 붙여넣습니다. 읽기 전용 엔드포인트이며 사용자 컨텍스트는 없습니다. + - **전체 경로** — OAuth 2.0 사용자 컨텍스트를 위해 `xurl mcp` 브리지를 실행합니다. 쓰기 작업(북마크, Articles) 및 사용자로서 동작하는 모든 도구에 필요합니다. + + 각 클라이언트 섹션(Grok Build, Cursor, Claude Desktop, VS Code 및 기타 MCP 클라이언트)에는 두 구성 스니펫이 모두 표시되어 있어 상황에 맞는 경로를 선택할 수 있습니다. + + ### Articles 초안 작성 및 게시 엔드포인트 diff --git a/pt/changelog.mdx b/pt/changelog.mdx index 278c54b65..9a73067d2 100644 --- a/pt/changelog.mdx +++ b/pt/changelog.mdx @@ -7,6 +7,19 @@ keywords: ["registro de alterações", "atualizações da API", "notas de versã Para se inscrever para receber atualizações, [**"Ative as notificações"**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive) para [**@API**](https://x.com/api). + + ### Novidade: conexão Bearer somente de app para o servidor X MCP + + Agora você pode conectar qualquer cliente MCP ao [servidor X MCP](/tools/mcp) hospedado usando apenas o Bearer token do seu app como cabeçalho `Authorization` — sem bridge local nem login pelo navegador. É a forma mais rápida de experimentar o servidor a partir de clientes que oferecem suporte a MCP remoto com cabeçalhos personalizados e se encaixa bem em fluxos somente leitura (buscas, lookups, trends e notícias). + + Agora documentamos duas rotas de início lado a lado: + + - **Simples** — cole seu Bearer token somente de app na configuração do cliente. Endpoints somente leitura; sem contexto de usuário. + - **Completa** — execute o bridge `xurl mcp` para obter contexto de usuário com OAuth 2.0. Necessária para escritas (bookmarks, Articles) e para qualquer ferramenta que aja como você. + + Cada seção de cliente (Grok Build, Cursor, Claude Desktop, VS Code e qualquer outro cliente MCP) mostra os dois snippets de configuração para que você escolha a rota que melhor se adapta. + + ### Endpoints de rascunho e publicação de Articles