Codex 세션을 끄지 않고 MCP 서버에 로그인하는 /mcp login

Codex CLI 0.161.0의 /mcp login으로 Linear MCP 서버에 로그인하는 순서를 /mcp 확인부터 도구가 붙기까지 따라가고, SSH로 붙은 서버에서 로그인하는 법과 토큰이 저장되는 곳, 로그아웃 명령을 보여 줍니다.

동딩

2026.10.12·3분 읽기·

#ai #mcp #workflow

로그인하라는 경고가 뜨는 MCP 서버

MCP 서버 중에는 Linear처럼 OAuth 로그인(브라우저에서 내 계정 권한을 허락하고 토큰을 받아 두는 절차)을 마쳐야 도구를 내주는 곳이 있습니다. Linear의 원격 MCP 서버를 등록하고 Codex를 열면 "The linear MCP server is not logged in."이라는 경고가 뜹니다.

toml

1# ~/.codex/config.toml
2[mcp_servers.linear]
3url = "https://mcp.linear.app/mcp"

경고는 codex mcp login linear를 실행하라고 안내합니다. 0.161.0부터는 세션을 닫고 다른 터미널로 갈 필요 없이 세션 안에서 /mcp login linear로 끝납니다.

/mcp는 세션에 붙은 MCP 서버와 서버마다 잡힌 도구 수를 보여 주는 명령입니다. 로그인 전후로 이 줄이 바뀌는지가 확인 기준입니다.

/mcp login linear로 Linear 도구가 붙기까지

나Codex 세션브라우저

1/mcp

2linear: 로그인 필요

3/mcp login linear

4Linear 허락 화면 열기

5허락

6Signed in to linear.

7다음 요청

나 → Codex 세션

로그인 전에는 linear가 authentication required (0 tools)로 나옵니다. 쓸 수 있는 도구가 없습니다.

나 → Codex 세션

/mcp login linear를 치면 세션이 브라우저에 Linear 허락 화면을 엽니다.

나 → 브라우저

권한을 허락하면 브라우저에 Authentication complete. 문구가 뜹니다. 창은 닫아도 됩니다.

Codex 세션 → 나

세션에 Signed in to linear.가 뜹니다.

나 → Codex 세션

세션을 다시 열지 않아도 다음 요청부터 Linear 도구를 씁니다. /mcp를 다시 치면 linear가 connected로 바뀝니다.

세션을 다시 열지 않아도 되는 것은 로그인이 성공하면 Codex가 열려 있는 세션의 MCP 연결을 새로 맺기 때문입니다.

SSH로 붙은 서버에서 브라우저가 안 뜰 때

원격 서버에서 돌리는 Codex는 내 노트북의 브라우저를 열지 못하고, 허락 뒤에 돌아올 주소(127.0.0.1 콜백)도 원격 서버를 가리킵니다.

	내 컴퓨터의 세션	SSH로 붙은 서버
로그인 명령	`/mcp login linear`	`codex mcp login linear --no-browser`
허락 화면	브라우저가 저절로 열림	찍힌 주소를 노트북 브라우저에 붙여 열기
마무리	저절로 끝남	주소창의 콜백 주소를 붙여 넣기

세션은 그대로 두고 다른 SSH 창에서 실행합니다. 허락한 뒤 노트북 주소창에 남은 127.0.0.1 주소를 통째로 복사해 마지막 줄에 붙여 넣습니다.

~/democodex mcp login

$ codex mcp login linear --no-browser

Authorize the MCP server by opening

this URL in your browser:

https://mcp.linear.app/authorize

?response_type=code&...

&redirect_uri=

http://127.0.0.1:60519/callback

After signing in, copy the full URL

from your browser's address bar.

Callback URL (input hidden):

--no-browser가 찍는 인증 주소와 붙여 넣을 자리

토큰이 저장되면 열려 있던 세션도 다음 요청에서 새 토큰을 찾아 linear에 다시 연결합니다.

토큰이 남는 곳과 로그아웃

토큰은 기본으로 OS 키체인에 Codex MCP Credentials라는 이름으로 저장되고, 키체인을 쓸 수 없으면 ~/.codex/.credentials.json에 저장됩니다. 파일은 같은 사용자로 도는 다른 프로그램도 읽을 수 있으니, 키체인만 쓰려면 config.toml에 mcp_oauth_credentials_store를 "keyring"으로 적습니다. 세션 안에는 로그아웃 명령이 없어서 토큰은 터미널에서 지웁니다.

bash

1codex mcp logout linear
2# Removed OAuth credentials for 'linear'.

0.161.0 이상이라면 시작할 때 로그인 경고가 떠도 세션을 닫지 말고 /mcp login <서버 이름>을 치고, /mcp에서 connected를 본 뒤 요청을 이어 가면 됩니다. 원격 서버에서 쓰는 경우에만 다른 창의 codex mcp login --no-browser로 돌아가고, 다 쓴 계정은 codex mcp logout으로 지웁니다.

Comments

로그인하라는 경고가 뜨는 MCP 서버

/mcp login linear 한 번에 보이는 화면

SSH로 붙은 서버에서 브라우저가 안 뜰 때

토큰이 남는 곳과 로그아웃

댓글